JapaneseCalendar Klasa

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Źródło:

JapaneseCalendar.cs

Reprezentuje kalendarz japoński.

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

public class JapaneseCalendar : System.Globalization.Calendar

type JapaneseCalendar = class
    inherit Calendar

Public Class JapaneseCalendar
Inherits Calendar

Dziedziczenie

Object

Calendar

JapaneseCalendar

Uwagi

Japoński kalendarz, znany również jako kalendarz Wareki, działa dokładnie tak jak kalendarz gregoriański, z wyjątkiem tego, że rok i era są inne.

Uwaga

Aby uzyskać informacje o korzystaniu z JapaneseCalendar klasy i innych klas kalendarza na platformie .NET, zobacz Praca z kalendarzami.

Japoński kalendarz rozpoznaje jedną erę dla każdego panowania cesarza. Dwie najnowsze epoki to era Heisei, począwszy od gregoriańskiego roku kalendarzowego 1989, a era Reiwa, począwszy od gregoriańskiego roku kalendarzowego 2019. Nazwa ery jest zwykle wyświetlana przed rokiem. Na przykład rok kalendarzowy gregoriański 2001 to japoński rok kalendarzowy Heisei 13. Należy pamiętać, że pierwszy rok ery nosi nazwę "Gannen". Dlatego rok kalendarzowy gregoriański 1989 był japońskim rokiem kalendarzowym Heisei Gannen. Domyślnie operacje formatowania z określonymi ciągami formatu daty i godziny, takimi jak "D", "F" i "Y", dane wyjściowe Gannen, a nie "1" w ciągu wynikowym.

Ważne

Era w japońskich kalendarzach opiera się na panowaniu cesarza i dlatego oczekuje się, że się zmieni. Na przykład 1 maja 2019 r. oznaczyła początek ery Reiwa w JapaneseCalendar erze i JapaneseLunisolarCalendar. Taka zmiana ery wpływa na wszystkie aplikacje korzystające z tych kalendarzy. Aby uzyskać więcej informacji i określić, czy twoje aplikacje mają wpływ, zobacz Obsługa nowej ery w kalendarzu japońskim na platformie .NET. Aby uzyskać informacje na temat testowania aplikacji w systemach Windows w celu zapewnienia gotowości do zmiany epoki, zobacz Przygotowywanie aplikacji do japońskiej zmiany epoki. Aby uzyskać informacje o funkcjach na platformie .NET, które obsługują kalendarze z wieloma erami i najlepsze rozwiązania dotyczące pracy z kalendarzami obsługującymi wiele epok, zobacz Praca z erami.

Ta klasa przypisuje liczby do epoki w następujący sposób:

Wartość GetEra	Nazwa ery	Skrót ery	Daty gregoriańskiego
5	令和 (Reiwa)	令和 (R, r)	1 maja 2019 r.
4	平成 (Heisei)	平 (H, h)	8 stycznia 1989 r. do 30 kwietnia 2019 r.
3	昭和 (Showa)	昭 (S, s)	25 grudnia 1926 r. do 7 stycznia 1989 r.
2	正 (Taisho)	} (T, t)	30 lipca 1912 r. do 24 grudnia 1926 r.
1	明治 (Meiji)	明 (M, m)	8 września 1868 do 29 lipca 1912 r.

Ta klasa obsługuje daty od 8 września w roku Meiji 1 (w kalendarzu gregoriańskim, 8 września 1868). Chociaż japoński kalendarz został przełączony z kalendarza księżycowego do kalendarza słonecznego w roku Meiji 6 (1873 z kalendarza gregoriańskiego), ta implementacja jest oparta tylko na kalendarzu słonecznym.

Lata przestępne w kalendarzu japońskim odpowiadają tym samym latom przestępnym w kalendarzu gregoriańskim. Rok przestępny w kalendarzu gregoriańskim jest definiowany jako rok gregoriański, który jest równomiernie podzielny przez cztery, z wyjątkiem tego, czy jest podzielny przez 100. Jednak lata gregoriańskie, które są podzielne przez 400 lat, to lata przestępne. Wspólny rok ma 365 dni, a rok przestępny ma 366 dni.

Japoński kalendarz ma od 12 miesięcy z 28 do 31 dni każdy:

Wartość GetMonth	Month (Miesiąc)	Angielski	Dni w wspólnych latach	Dni w latach przestępnych
1	1月 (Ichigatsu)	January (Styczeń)	31	31
2	2月 (Nigatsu)	Luty	28	29
3	3月 (Sangatsu)	Marzec	31	31
4	4月 (Shigatsu)	Kwiecień	30	30
5	5月 (Gogatsu)	Maj	31	31
6	6月 (Rokugatsu)	Czerwiec	30	30
7	7月 (Shichigatsu)	Lipiec	31	31
8	8月 (Hachigatsu)	Sierpień	31	31
9	9月 (Kugatsu)	Wrzesień	30	30
10	10月 (Juugatsu)	Październik	31	31
11	11月 (Juuichigatsu)	Listopad	30	30
12	12月 (Juunigatsu)	Grudzień	31	31

Nigatsu, który jest odpowiednikiem gregoriańskiego miesiąca kalendarzowego lutego, ma 29 dni w latach przestępnych i 28 w ciągu wspólnych lat.

Data 1 stycznia 2001 r. w kalendarzu gregoriańskim jest odpowiednikiem pierwszego dnia Ichigatsu w roku Heisei 13 w kalendarzu japońskim.

Jeśli jest JapaneseCalendar to bieżący kalendarz kultury japońskiej, DateTime.Parse rozpoznaje skróty epoki przed rokiem. Skrót jest skrótem alfabetu łacińskiego bez uwzględniania wielkości liter lub skrótem Kanji z pojedynczym znakiem. DateTime.Parse rozpoznaje również "1" lub Gannen (元年) jako pierwszy rok epoki.

Każdy CultureInfo obiekt obsługuje zestaw kalendarzy. Właściwość Calendar zwraca domyślny kalendarz kultury, a OptionalCalendars właściwość zwraca tablicę zawierającą wszystkie kalendarze obsługiwane przez kulturę. Aby zmienić kalendarz używany przez element CultureInfo, ustaw DateTimeFormatInfo.Calendar właściwość na nową Calendarwartość .

Konstruktory

JapaneseCalendar()

Inicjuje nowe wystąpienie klasy JapaneseCalendar.

Pola

CurrentEra

Reprezentuje bieżącą erę bieżącego kalendarza. Wartość tego pola to 0. (Odziedziczone po Calendar)

Właściwości

AlgorithmType	Pobiera wartość wskazującą, czy bieżący kalendarz jest oparty na słońcu, oparty na księżycu, czy kombinacji obu.
DaysInYearBeforeMinSupportedYear	Pobiera liczbę dni w roku poprzedzającym rok określony przez MinSupportedDateTime właściwość . (Odziedziczone po Calendar)
Eras	Pobiera listę era w elemecie JapaneseCalendar.
IsReadOnly	Pobiera wartość wskazującą, czy ten Calendar obiekt jest tylko do odczytu. (Odziedziczone po Calendar)
MaxSupportedDateTime	Pobiera najnowszą datę i godzinę obsługiwaną przez bieżący JapaneseCalendar obiekt.
MinSupportedDateTime	Pobiera najwcześniejszą datę i godzinę obsługiwaną przez bieżący JapaneseCalendar obiekt.
TwoDigitYearMax	Pobiera lub ustawia ostatni rok zakresu 100-letniego, który może być reprezentowany przez 2-cyfrowy rok.

Metody

AddDays(DateTime, Int32)	DateTime Zwraca wartość , która jest określoną liczbą dni od określonej DateTimewartości . (Odziedziczone po Calendar)
AddHours(DateTime, Int32)	DateTime Zwraca wartość , która jest określoną liczbą godzin od określonej DateTimewartości . (Odziedziczone po Calendar)
AddMilliseconds(DateTime, Double)	DateTime Zwraca określoną liczbę milisekund od określonej DateTimewartości . (Odziedziczone po Calendar)
AddMinutes(DateTime, Int32)	DateTime Zwraca wartość , która jest określoną liczbą minut od określonej DateTimewartości . (Odziedziczone po Calendar)
AddMonths(DateTime, Int32)	DateTime Zwraca wartość , która jest określoną liczbą miesięcy od określonej DateTimewartości .
AddSeconds(DateTime, Int32)	DateTime Zwraca wartość , która jest określoną liczbą sekund od określonej DateTimewartości . (Odziedziczone po Calendar)
AddWeeks(DateTime, Int32)	DateTime Zwraca wartość , która jest określoną liczbą tygodni od określonej DateTimewartości . (Odziedziczone po Calendar)
AddYears(DateTime, Int32)	DateTime Zwraca wartość , która jest określoną liczbą lat od określonej DateTimewartości .
Clone()	Tworzy nowy obiekt, który jest kopią bieżącego Calendar obiektu. (Odziedziczone po Calendar)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetDayOfMonth(DateTime)	Zwraca dzień miesiąca w określonym obiekcie DateTime.
GetDayOfWeek(DateTime)	Zwraca dzień tygodnia w określonym obiekcie DateTime.
GetDayOfYear(DateTime)	Zwraca dzień roku w określonym obiekcie DateTime.
GetDaysInMonth(Int32, Int32)	Zwraca liczbę dni w określonym miesiącu i roku bieżącej ery. (Odziedziczone po Calendar)
GetDaysInMonth(Int32, Int32, Int32)	Zwraca liczbę dni w określonym miesiącu w określonym roku w określonej erze.
GetDaysInYear(Int32)	Zwraca liczbę dni w określonym roku bieżącej ery. (Odziedziczone po Calendar)
GetDaysInYear(Int32, Int32)	Zwraca liczbę dni w określonym roku w określonej erze.
GetEra(DateTime)	Zwraca erę w określonej erze DateTime.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetHour(DateTime)	Zwraca wartość godzin w określonym obiekcie DateTime. (Odziedziczone po Calendar)
GetLeapMonth(Int32)	Oblicza miesiąc przestępny dla określonego roku. (Odziedziczone po Calendar)
GetLeapMonth(Int32, Int32)	Oblicza miesiąc przestępny dla określonego roku i ery.
GetMilliseconds(DateTime)	Zwraca wartość milisekund w określonej wartości DateTime. (Odziedziczone po Calendar)
GetMinute(DateTime)	Zwraca wartość minut w określonej wartości DateTime. (Odziedziczone po Calendar)
GetMonth(DateTime)	Zwraca miesiąc w określonym obiekcie DateTime.
GetMonthsInYear(Int32)	Zwraca liczbę miesięcy w określonym roku w bieżącej erze. (Odziedziczone po Calendar)
GetMonthsInYear(Int32, Int32)	Zwraca liczbę miesięcy w określonym roku w określonej erze.
GetSecond(DateTime)	Zwraca wartość sekund w określonej wartości DateTime. (Odziedziczone po Calendar)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Zwraca tydzień roku, który zawiera datę w określonym obiekcie DateTime.
GetYear(DateTime)	Zwraca rok w określonym obiekcie DateTime.
IsLeapDay(Int32, Int32, Int32)	Określa, czy określona data w bieżącej erze jest dniem przestępnym. (Odziedziczone po Calendar)
IsLeapDay(Int32, Int32, Int32, Int32)	Określa, czy określona data w określonej erze jest dniem przestępnym.
IsLeapMonth(Int32, Int32)	Określa, czy określony miesiąc w określonym roku w bieżącej erze jest miesiącem przestępnym. (Odziedziczone po Calendar)
IsLeapMonth(Int32, Int32, Int32)	Określa, czy określony miesiąc w określonym roku w określonej erze jest miesiącem przestępnym.
IsLeapYear(Int32)	Określa, czy określony rok w bieżącej epoce jest rokiem przestępnym. (Odziedziczone po Calendar)
IsLeapYear(Int32, Int32)	Określa, czy określony rok w określonej erze jest rokiem przestępnym.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	DateTime Zwraca wartość ustawioną na określoną datę i godzinę w bieżącej erze. (Odziedziczone po Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	DateTime Zwraca wartość ustawioną na określoną datę i godzinę w określonej erze.
ToFourDigitYear(Int32)	Konwertuje określony rok na czterocyfrowy rok przy użyciu właściwości w TwoDigitYearMax celu określenia odpowiedniego wieku.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Calendar
• GregorianCalendar
• Calendar
• OptionalCalendars
• Praca z kalendarzami