JapaneseCalendar Třída

Definice

Obor názvů:

System.Globalization

Sestavení:

System.Runtime.dll

Zdroj:

JapaneseCalendar.cs

Představuje japonský kalendář.

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

public class JapaneseCalendar : System.Globalization.Calendar

type JapaneseCalendar = class
    inherit Calendar

Public Class JapaneseCalendar
Inherits Calendar

Dědičnost

Object

Calendar

JapaneseCalendar

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.
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.
MinSupportedDateTime	Získá nejstarší datum a čas podporovaný aktuálním JapaneseCalendar objektem.
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.
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.
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)

Viz také

• Calendar
• GregorianCalendar
• Calendar
• OptionalCalendars
• Práce s kalendáři