JapaneseCalendar Třída
Definice
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::Calendarpublic 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.Calendartype JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
type JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
inherit CalendarPublic Class JapaneseCalendar
Inherits Calendar- Dědičnost
- Atributy
Poznámky
Japonský kalendář, který je také známý jako kalendář Wareki, funguje stejně jako gregoriánský kalendář, s tím rozdílem, že rok a éra jsou odlišné.
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 vládu každého císaře. Dvě nejnovější éry jsou éra Heisei, počínaje gregoriánským kalendářním rokem 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 "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ěten 2019 označil začátek éry Reiwa v JapaneseCalendar éře a JapaneseLunisolarCalendar. Taková změna éry ovlivní všechny aplikace, které tyto kalendáře používají. Další informace a informace o tom, jestli jsou vaše aplikace ovlivněné, 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. Informace o funkcích 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 převeden z lunárního kalendáře na solární kalendář v roce Meiji 6 (1873 gregoriánského kalendáře), tato implementace je 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 bez rozlišování velkých a velkých písmen, 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 solární, lunární nebo kombinace 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 .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 100letého rozsahu, který může být reprezentován 2místný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) |
DateTime Vrátí hodnotu, která je zadaný počet hodin od zadaného DateTimeparametru . (Zděděno od Calendar) |
| AddMilliseconds(DateTime, Double) |
Vrátí hodnotu DateTime , která je zadaný počet milisekund od zadaného DateTimeparametru . (Zděděno od Calendar) |
| AddMinutes(DateTime, Int32) |
Vrátí hodnotu DateTime , která je zadaný počet minut od zadaného DateTimeparametru . (Zděděno od Calendar) |
| AddMonths(DateTime, Int32) |
Vrátí hodnotu DateTime , která je zadaný počet měsíců od zadaného DateTimeparametru . |
| AddSeconds(DateTime, Int32) |
DateTime Vrátí hodnotu, která je zadaný počet sekund od zadaného DateTimeparametru . (Zděděno od Calendar) |
| AddWeeks(DateTime, Int32) |
DateTime Vrátí hodnotu, která je zadaný počet týdnů od zadaného DateTimeparametru . (Zděděno od Calendar) |
| AddYears(DateTime, Int32) |
DateTime Vrátí hodnotu, která je zadaný počet roků od zadaného DateTime. |
| 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 DateTimeparametru . |
| 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 minutes v zadané DateTimehodnotě . (Zděděno od Calendar) |
| GetMonth(DateTime) |
Vrátí měsíc v zadaném .DateTime |
| 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() |
Získá aktuální Type instanci. (Zděděno od Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Vrátí týden v roce, který zahrnuje datum v zadaném DateTime. |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Vrátí týden v roce, který zahrnuje 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 zadané datum v aktuální éře je přestupný den. (Zděděno od Calendar) |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Určuje, zda zadané datum v zadané éře je přestupný den. |
| IsLeapMonth(Int32, Int32) |
Určuje, zda zadaný měsíc v zadaném roce v aktuální éře je přestupný měsíc. (Zděděno od Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Určuje, zda zadaný měsíc v zadaném roce v zadané éře je přestupný měsíc. |
| IsLeapYear(Int32) |
Určuje, zda zadaný rok v aktuální éře je přestupný rok. (Zděděno od Calendar) |
| IsLeapYear(Int32, Int32) |
Určuje, zda zadaný rok v zadané éře je 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) |
DateTime Vrátí hodnotu, která je nastavena na zadané datum a čas v aktuální éře. (Zděděno od Calendar) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
DateTime Vrátí hodnotu, která je nastavena 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) |
