JapaneseCalendar Třída

Definice

Obor názvů:

System.Globalization

Sestavení:

netstandard.dll, 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 Wareki kalendář, funguje přesně stejně jako gregoriánský kalendář s tím rozdílem, že rok a éra jsou odlišné.

Note

Informace o používání JapaneseCalendar třídy a dalších tříd kalendáře v .NET naleznete 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 heisei éra, počínaje gregoriánským kalendářním rokem 1989 a reiwa éry 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ý kalendářní rok Heisei Gannen. Ve výchozím nastavení operace formátování se zadanými řetězci formátu data a času, jako jsou "D", "F" a "Y", výstup Gannen místo "1" ve výsledném řetězci.

Important

É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 označilo začátek období Reiwa v JapaneseCalendar a JapaneseLunisolarCalendar. Taková změna éry ovlivňuje všechny aplikace, které tyto kalendáře používají. Další informace a určení, zda jsou ovlivněny vaše aplikace, naleznete v tématu Zpracování nové éry v japonském kalendáři v .NET. Informace o testování aplikací v systémech Windows za účelem zajištění připravenosti na změnu v éře najdete v tématu Příprava aplikace na změnu japonské éry. Funkce v .NET, které podporují kalendáře s více obdobími a osvědčené postupy při práci s kalendáři, které podporují více období, najdete v tématu Práce s obdobími.

Tato třída přiřazuje čísla k eras následujícím způsobem:

Hodnota GetEra	Název éry	Éra – zkratka	Gregoriánský termín
5	令和 (Reiwa)	令和 (R, r)	1. května 2019
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 až 24. prosince 1926
1	明治 (Meiji)	明 (M, m)	23. října 1868 do 29. července 1912

Tato třída zpracovává data z října 23 v roce Meiji 1 (v gregoriánském kalendáři, 23. října 1868). I když byl japonský kalendář 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 sluneční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řípadů, kdy je dělitelný 100. Gregoriánské roky, které jsou dělitelné 400 jsou přestupné roky. Běžný rok má 365 dní a přestupný rok má 366 dní.

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

Hodnota GetMonth	Měsíc	Angličtina	Dny v běžných letech	Dny v přestupném roce
1	1月 (Ichigatsu)	Leden	31	31
2	2月 (Nigatsu)	Únor	28	29
3	3月 (Sangatsu)	Březen	31	31
4	4月 (Shigatsu)	Dubna	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)	Listopadu	30	30
12	12月 (Juunigatsu)	prosinec	31	31

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

Datum 1. ledna 2001 A.D. 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é kultury, DateTime.Parse rozpozná zkratky éry před rokem. Zkratka je buď jednoznaková zkratka latinky nerozlišující velká a malá 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ář jazykové verze a OptionalCalendars vlastnost vrátí pole obsahující všechny kalendáře podporované jazykovou verzí. Chcete-li změnit kalendář používaný objektem CultureInfo, nastavte DateTimeFormatInfo.Calendar vlastnost na nový Calendar.

Konstruktory

Name	Description
JapaneseCalendar()	Inicializuje novou instanci JapaneseCalendar třídy.

Pole

Name	Description
CurrentEra	Představuje aktuální éru aktuálního kalendáře. Hodnota tohoto pole je 0. (Zděděno od Calendar)

Vlastnosti

Name	Description
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í rok, který je určen vlastností MinSupportedDateTime . (Zděděno od Calendar)
Eras	Získá seznam období v JapaneseCalendar.
IsReadOnly	Získá hodnotu určující, zda tento Calendar objekt je 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 100-rok rozsahu, který může být reprezentován dvoumístným rokem.

Metody

Name	Description
AddDays(DateTime, Int32)	DateTime Vrátí zadaný počet dnů od zadaného DateTimeparametru . (Zděděno od Calendar)
AddHours(DateTime, Int32)	DateTime Vrátí zadaný počet hodin od zadaného DateTimeparametru . (Zděděno od Calendar)
AddMilliseconds(DateTime, Double)	DateTime Vrátí zadaný počet milisekund od zadaného DateTimeparametru . (Zděděno od Calendar)
AddMinutes(DateTime, Int32)	Vrátí zadaný DateTime počet minut od zadaného DateTimeparametru . (Zděděno od Calendar)
AddMonths(DateTime, Int32)	DateTime Vrátí zadaný počet měsíců od zadaného DateTimeparametru .
AddSeconds(DateTime, Int32)	Vrátí zadaný DateTime počet sekund od zadaného DateTimeparametru . (Zděděno od Calendar)
AddWeeks(DateTime, Int32)	DateTime Vrátí zadaný počet týdnů od zadaného DateTimeparametru . (Zděděno od Calendar)
AddYears(DateTime, Int32)	DateTime Vrátí zadaný počet let od zadaného DateTime.
Clone()	Vytvoří nový objekt, který je kopií aktuálního Calendar objektu. (Zděděno od Calendar)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetDayOfMonth(DateTime)	Vrátí den v měsíci v zadaném DateTime.
GetDayOfWeek(DateTime)	Vrátí den v týdnu v zadaném DateTime.
GetDayOfYear(DateTime)	Vrátí den v roce v zadaném DateTime.
GetDaysInMonth(Int32, Int32, Int32)	Vrátí počet dní v zadaném měsíci v zadaném roce v zadaném období.
GetDaysInMonth(Int32, Int32)	Vrátí počet dní v zadaném měsíci a roce aktuální éry. (Zděděno od Calendar)
GetDaysInYear(Int32, Int32)	Vrátí počet dní v zadaném roce v zadaném období.
GetDaysInYear(Int32)	Vrátí počet dní v zadaném roce aktuální éry. (Zděděno od Calendar)
GetEra(DateTime)	Vrátí éru v zadaném DateTime.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetHour(DateTime)	Vrátí hodnotu hodin v zadané DateTimehodnotě . (Zděděno od Calendar)
GetLeapMonth(Int32, Int32)	Vypočítá přestupný měsíc pro zadaný rok a éru.
GetLeapMonth(Int32)	Vypočítá přestupný měsíc pro zadaný rok. (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ém DateTimeargumentu . (Zděděno od Calendar)
GetMonth(DateTime)	Vrátí měsíc v zadaném parametru DateTime.
GetMonthsInYear(Int32, Int32)	Vrátí početměsícůch
GetMonthsInYear(Int32)	Vrátí počet měsíců v zadaném roce v aktuální éře. (Zděděno od Calendar)
GetSecond(DateTime)	Vrátí hodnotu sekund v zadané DateTimehodnotě . (Zděděno od Calendar)
GetType()	Získá Type 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.
GetYear(DateTime)	Vrátí rok v zadaném DateTimeparametru .
IsLeapDay(Int32, Int32, Int32, Int32)	Určuje, zda zadané datum v zadané éře je přestupný den.
IsLeapDay(Int32, Int32, Int32)	Určuje, zda zadané datum v aktuální éře je přestupný den. (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.
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)
IsLeapYear(Int32, Int32)	Určuje, zda zadaný rok v zadané éře je přestupný rok.
IsLeapYear(Int32)	Určuje, zda zadaný rok v aktuální éře je přestupný rok. (Zděděno od Calendar)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Vrátí hodnotu nastavenou DateTime na zadané datum a čas v zadané éře.
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)
ToFourDigitYear(Int32)	Převede zadaný rok na čtyřciferný 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