JapaneseCalendar Třída

Reference

Definice

Obor názvů:: System.Globalization

Sestavení:: mscorlib.dll, System.Globalization.Calendars.dll

Sestavení:: System.Runtime.dll

Sestavení:: System.Globalization.Calendars.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje japonský kalendář.

public ref class JapaneseCalendar : System::Globalization::Calendar

public class JapaneseCalendar : System.Globalization.Calendar

[System.Serializable]
public class JapaneseCalendar : System.Globalization.Calendar

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class JapaneseCalendar : System.Globalization.Calendar

type JapaneseCalendar = class
    inherit Calendar

[<System.Serializable>]
type JapaneseCalendar = class
    inherit Calendar

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
    inherit Calendar

Public Class JapaneseCalendar
Inherits Calendar

Dědičnost: Object

Calendar
JapaneseCalendar

Atributy: SerializableAttribute ComVisibleAttribute

Poznámky

Japonský kalendář, který je také známý jako kalendář Wareki, funguje přesně stejně jako gregoriánský kalendář s tím rozdílem, že rok a éra se liší.

Poznámka

Informace o používání JapaneseCalendar třídy a dalších tříd kalendáře v .NET najdete v tématu Práce s kalendáři.

Japonský kalendář rozpoznává jednu éru pro každou vládu císaře. Dvě nejnovější éry jsou éra Heisei, která začíná v gregoriánském kalendářním roce 1989, a éra Reiwa, počínaje gregoriánským kalendářním rokem 2019. Název éry se obvykle zobrazuje před rokem. Například gregoriánský kalendářní rok 2001 je japonský kalendářní rok Heisei 13. Všimněte si, že první rok éry se nazývá Gannen. Proto byl gregoriánský kalendářní rok 1989 japonským kalendářním rokem Heisei Gannen. Ve výchozím nastavení operace formátování se zadanými řetězci formátu data a času, například "D", "F" a "Y", ve výsledném řetězci vypíše gannen místo hodnoty 1.

Důležité

Éry v japonských kalendářích jsou založeny na vládě císaře, a proto se očekává, že se změní. Například 1. května 2019 byl začátek éry Reiwa v JapaneseCalendar a JapaneseLunisolarCalendar. Taková změna éry ovlivní všechny aplikace, které tyto kalendáře používají. Další informace a informace o tom, jestli se to týká vašich aplikací, najdete v tématu Zpracování nové éry v japonském kalendáři v .NET. Informace o testování aplikací v systémech Windows pro zajištění jejich připravenosti na změnu éry najdete v tématu Příprava aplikace na změnu japonské éry. Funkce v .NET, které podporují kalendáře s více érami, a osvědčené postupy při práci s kalendáři, které podporují více ér, najdete v tématu Práce s érami.

Tato třída přiřadí čísla k érám následujícím způsobem:

Hodnota GetEra	Název éry	Zkratka éry	Gregoriánská data
5	令和 (Reiwa)	令和 (R, r)	Od 1. května 2019 do současnosti
4	平成 (Heisei)	平 (H, h)	8. ledna 1989 až 30. dubna 2019
3	昭和 (Showa)	昭 (S, s)	25. prosince 1926 až 7. ledna 1989
2	大正 (Taisho)	大 (T, t)	30. července 1912 - 24. prosince 1926
1	明治 (Meiji)	明 (M, m)	8. září 1868 - 29. července 1912

Tato třída zpracovává data od 8. září v roce Meiji 1 (v gregoriánském kalendáři, 8. září 1868). Ačkoli japonský kalendář byl v roce Meiji 6 (1873 gregoriánského kalendáře) převeden z lunárního kalendáře na solární kalendář, je tato implementace založena pouze na solárním kalendáři.

Přestupné roky v japonském kalendáři odpovídají stejným přestupným rokům v gregoriánském kalendáři. Přestupný rok v gregoriánském kalendáři je definován jako gregoriánský rok, který je rovnoměrně dělitelný čtyřmi, s výjimkou případu, kdy je dělitelný 100. Gregoriánské roky, které jsou dělitelné 400, jsou však přestupnými roky. Běžný rok má 365 dnů a přestupný rok 366 dnů.

Japonský kalendář má 12 měsíců s 28 až 31 dny:

Hodnota GetMonth	Month (Měsíc)	Angličtina	Dny v běžných letech	Dny v přestupných letech
1	1月 (Ichigatsu)	January (Leden)	31	31
2	2月 (Nigatsu)	Únor	28	29
3	3月 (Sangatsu)	Březen	31	31
4	4月 (Shigatsu)	Duben	30	30
5	5月 (Gogatsu)	Květen	31	31
6	6月 (Rokugatsu)	Červen	30	30
7	7月 (Shichigatsu)	Červenec	31	31
8	8月 (Hachigatsu)	Srpen	31	31
9	9月 (Kugatsu)	Září	30	30
10	10月 (Juugatsu)	Říjen	31	31
11	11月 (Juuichigatsu)	Listopad	30	30
12	12月 (Juunigatsu)	Prosinec	31	31

Nigatsu, který je ekvivalentem únorového gregoriánského kalendáře, má 29 dní v přestupných letech a 28 dní během běžných let.

Datum 1. ledna 2001 v gregoriánském kalendáři odpovídá prvnímu dni Ichigatsu v roce Heisei 13 v japonském kalendáři.

JapaneseCalendar Pokud je aktuální kalendář japonské jazykové verze, DateTime.Parse rozpozná zkratky éry před rokem. Zkratka je buď zkratka latinky, která nerozlišuje malá a velká písmena, nebo zkratka Kanji s jedním znakem. DateTime.Parse rozpoznává také "1" nebo Gannen (元年) jako první rok éry.

Každý CultureInfo objekt podporuje sadu kalendářů. Vlastnost Calendar vrátí výchozí kalendář pro jazykovou verzi a OptionalCalendars vlastnost vrátí pole obsahující všechny kalendáře podporované jazykovou verzí. Pokud chcete změnit kalendář používaný objektem CultureInfo, nastavte DateTimeFormatInfo.Calendar vlastnost na nový Calendar.

Konstruktory

JapaneseCalendar()

Inicializuje novou instanci JapaneseCalendar třídy .

Pole

CurrentEra

Představuje aktuální éru aktuálního kalendáře. Hodnota tohoto pole je 0.

(Zděděno od Calendar)

Vlastnosti

AlgorithmType	Získá hodnotu, která označuje, zda aktuální kalendář je solární, lunární nebo kombinace obou.
AlgorithmType	Získá hodnotu označující, zda aktuální kalendář je založen na slunečním, lunárním nebo kombinaci obou. (Zděděno od Calendar)
DaysInYearBeforeMinSupportedYear	Získá počet dní v roce, který předchází roku, který je určen MinSupportedDateTime vlastností. (Zděděno od Calendar)
Eras	Získá seznam ér v objektu JapaneseCalendar.
IsReadOnly	Získá hodnotu označující, zda je tento Calendar objekt jen pro čtení. (Zděděno od Calendar)
MaxSupportedDateTime	Získá nejnovější datum a čas podporovaný aktuálním JapaneseCalendar objektem.
MaxSupportedDateTime	Získá nejnovější datum a čas podporovaný tímto Calendar objektem. (Zděděno od Calendar)
MinSupportedDateTime	Získá nejstarší datum a čas podporovaný aktuálním JapaneseCalendar objektem.
MinSupportedDateTime	Získá nejstarší datum a čas podporovaný tímto Calendar objektem. (Zděděno od Calendar)
TwoDigitYearMax	Získá nebo nastaví poslední rok rozsahu 100 let, který může být reprezentován 2ciferným rokem.

Metody

AddDays(DateTime, Int32)	Vrátí hodnotu DateTime , která je zadaný počet dní od zadaného DateTimeparametru . (Zděděno od Calendar)
AddHours(DateTime, Int32)	Vrátí hodnotu DateTime , která je zadaný počet hodin vzdálený od zadaného DateTimeparametru . (Zděděno od Calendar)
AddMilliseconds(DateTime, Double)	Vrátí hodnotu DateTime , která je zadaný počet milisekund od zadané DateTimehodnoty . (Zděděno od Calendar)
AddMinutes(DateTime, Int32)	Vrátí hodnotu DateTime , která je od zadaného počtu minut vzdálená od zadaného DateTimeparametru . (Zděděno od Calendar)
AddMonths(DateTime, Int32)	Vrátí hodnotu DateTime , která je zadaný počet měsíců vzdálený od zadaného DateTimeparametru .
AddSeconds(DateTime, Int32)	Vrátí hodnotu DateTime , která je zadaný počet sekund od zadaného DateTimeparametru . (Zděděno od Calendar)
AddWeeks(DateTime, Int32)	Vrátí hodnotu DateTime , která je zadaný počet týdnů od zadaného DateTimeparametru . (Zděděno od Calendar)
AddYears(DateTime, Int32)	Vrátí hodnotu DateTime , která je zadaný počet roků vzdálených od zadaného DateTimeparametru .
Clone()	Vytvoří nový objekt, který je kopií aktuálního Calendar objektu. (Zděděno od Calendar)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetDayOfMonth(DateTime)	Vrátí den v měsíci v zadané DateTimehodnotě .
GetDayOfWeek(DateTime)	Vrátí den v týdnu v zadané DateTimehodnotě .
GetDayOfYear(DateTime)	Vrátí den v roce v zadané DateTimehodnotě .
GetDaysInMonth(Int32, Int32)	Vrátí počet dní v zadaném měsíci a roce aktuální éry. (Zděděno od Calendar)
GetDaysInMonth(Int32, Int32, Int32)	Vrátí počet dní v zadaném měsíci v zadaném roce v zadané éře.
GetDaysInYear(Int32)	Vrátí počet dní v zadaném roce aktuální éry. (Zděděno od Calendar)
GetDaysInYear(Int32, Int32)	Vrátí počet dní v zadaném roce v zadané éře.
GetEra(DateTime)	Vrátí éru v zadaném .DateTime
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetHour(DateTime)	Vrátí hodnotu hodin v zadané DateTimehodnotě . (Zděděno od Calendar)
GetLeapMonth(Int32)	Vypočítá přestupný měsíc pro zadaný rok. (Zděděno od Calendar)
GetLeapMonth(Int32, Int32)	Vypočítá přestupný měsíc pro zadaný rok a éru.
GetLeapMonth(Int32, Int32)	Vypočítá přestupný měsíc pro zadaný rok a éru. (Zděděno od Calendar)
GetMilliseconds(DateTime)	Vrátí hodnotu milisekund v zadané DateTimehodnotě . (Zděděno od Calendar)
GetMinute(DateTime)	Vrátí hodnotu minut v zadané DateTimehodnotě . (Zděděno od Calendar)
GetMonth(DateTime)	Vrátí měsíc v zadané DateTimehodnotě .
GetMonthsInYear(Int32)	Vrátí počet měsíců v zadaném roce v aktuální éře. (Zděděno od Calendar)
GetMonthsInYear(Int32, Int32)	Vrátí počet měsíců v zadaném roce v zadané éře.
GetSecond(DateTime)	Vrátí hodnotu sekund v zadané DateTimehodnotě . (Zděděno od Calendar)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Vrátí týden v roce, který obsahuje datum v zadaném DateTime.
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Vrátí týden v roce, který obsahuje datum v zadané DateTime hodnotě. (Zděděno od Calendar)
GetYear(DateTime)	Vrátí rok v zadaném .DateTime
IsLeapDay(Int32, Int32, Int32)	Určuje, zda je zadané datum v aktuální éře přestupný den. (Zděděno od Calendar)
IsLeapDay(Int32, Int32, Int32, Int32)	Určuje, zda je zadané datum v zadané éře přestupný den.
IsLeapMonth(Int32, Int32)	Určuje, zda je zadaný měsíc v zadaném roce v aktuální éře přestupný měsíc. (Zděděno od Calendar)
IsLeapMonth(Int32, Int32, Int32)	Určuje, zda je zadaný měsíc v zadaném roce v zadané éře přestupný měsíc.
IsLeapYear(Int32)	Určuje, zda je zadaný rok v aktuální éře přestupný rok. (Zděděno od Calendar)
IsLeapYear(Int32, Int32)	Určuje, zda je zadaný rok v zadané éře přestupný rok.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Vrátí hodnotu nastavenou DateTime na zadané datum a čas v aktuální éře. (Zděděno od Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Vrátí hodnotu nastavenou DateTime na zadané datum a čas v zadané éře.
ToFourDigitYear(Int32)	Převede zadaný rok na čtyřmístný rok pomocí TwoDigitYearMax vlastnosti k určení příslušného století.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro