JapaneseCalendar Klasa

Definicja

Reprezentuje kalendarz japoński.

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
Dziedziczenie
JapaneseCalendar
Atrybuty

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 ostatnie 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. oznaczało 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 do 7 stycznia 1989 r.
2 正 (Taisho) ... (T, t) 30 lipca 1912 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 na kalendarz słoneczny w roku Meiji 6 (1873 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 sytuacji, gdy jest podzielny przez 100. Jednak lata gregoriańskie, które są podzielne przez 400 lat przestępnych. Wspólny rok ma 365 dni, a rok przestępny ma 366 dni.

Kalendarz japoński 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 wspólnych latach.

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

JapaneseCalendar Jeśli jest 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 z pojedynczym znakiem 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 też kombinacja obu tych opcji.

AlgorithmType

Pobiera wartość wskazującą, czy bieżący kalendarz jest oparty na słońcu, oparty na księżycu, czy też kombinacja obu.

(Odziedziczone po Calendar)
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.

MaxSupportedDateTime

Pobiera najnowszą datę i godzinę obsługiwaną przez ten Calendar obiekt.

(Odziedziczone po Calendar)
MinSupportedDateTime

Pobiera najwcześniejszą datę i godzinę obsługiwaną przez bieżący JapaneseCalendar obiekt.

MinSupportedDateTime

Pobiera najwcześniejszą datę i godzinę obsługiwaną przez ten Calendar obiekt.

(Odziedziczone po Calendar)
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.

GetLeapMonth(Int32, Int32)

Oblicza miesiąc przestępny dla określonego roku i ery.

(Odziedziczone po Calendar)
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.

GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Zwraca tydzień roku, który zawiera datę w określonej DateTime wartości.

(Odziedziczone po Calendar)
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)

Dotyczy

Zobacz też