JapaneseCalendar Klasse

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Quelle:

JapaneseCalendar.cs

Stellt den japanischen Kalender dar.

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

public class JapaneseCalendar : System.Globalization.Calendar

type JapaneseCalendar = class
    inherit Calendar

Public Class JapaneseCalendar
Inherits Calendar

Vererbung

Object

Calendar

JapaneseCalendar

Hinweise

Der japanische Kalender, der auch als Wareki-Kalender bekannt ist, funktioniert genau wie der gregorianische Kalender, mit dem Unterschied, dass das Jahr und die Epoche unterschiedlich sind.

Hinweis

Informationen zur Verwendung der JapaneseCalendar -Klasse und der anderen Kalenderklassen in .NET finden Sie unter Arbeiten mit Kalendern.

Der japanische Kalender erkennt eine Ära für die Herrschaft jedes Kaisers an. Die beiden jüngsten Epochen sind die Heisei-Ära, die im gregorianischen Kalenderjahr 1989 beginnt, und die Reiwa-Ära, die im gregorianischen Kalenderjahr 2019 beginnt. Der Name der Ära wird in der Regel vor dem Jahr angezeigt. Das gregorianische Kalenderjahr 2001 ist beispielsweise das japanische Kalenderjahr Heisei 13. Beachten Sie, dass das erste Jahr einer Ära "Gannen" genannt wird. Daher war das gregorianische Kalenderjahr 1989 das japanische Kalenderjahr Heisei Gannen. Standardmäßig geben Formatierungsvorgänge mit angegebenen Datums- und Uhrzeitformatzeichenfolgen wie "D", "F" und "Y" Gannen anstelle von "1" in der Ergebniszeichenfolge aus.

Wichtig

Die Zeitrechnung in japanischen Kalendern basiert auf den Regierungsperioden der Kaiser und wird sich daher erwartungsgemäß ändern. Beispiel: Der 1. Mai 2019 markiert den Beginn des Reiwa-Zeitabschnitts in den Kalendern des Typs JapaneseCalendar und JapaneseLunisolarCalendar. Eine derartige Änderung der Zeitabschnitte betrifft alle Anwendungen, die diese Kalender verwenden. Weitere Informationen und informationen zum Ermitteln, ob Ihre Anwendungen betroffen sind, finden Sie unter Behandeln einer neuen Ära im japanischen Kalender in .NET. Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um ihre Bereitschaft für die Änderung der Ära sicherzustellen, finden Sie unter Vorbereiten der Anwendung für die Änderung der japanischen Ära. Features in .NET, die Kalender mit mehreren Epochen unterstützen, und bewährte Methoden für die Arbeit mit Kalendern, die mehrere Epochen unterstützen, finden Sie unter Arbeiten mit Epochen.

Diese Klasse weist den Epochen wie folgt Zahlen zu:

GetEra-Wert	Name der Ära	Era-Abkürzung	Gregorianische Daten
5	令和 (Reiwa)	令和 (R, r)	1. Mai 2019 bis heute
4	平成 (Heisei)	平 (H, h)	8. Januar 1989 bis 30. April 2019
3	昭和 (Showa)	昭 (S, s)	25. Dezember 1926 bis 7. Januar 1989
2	大正 (Taisho)	大 (T, t)	30. Juli 1912 bis 24. Dezember 1926
1	明治 (Meiji)	明 (M, m)	8. September 1868 bis 29. Juli 1912

Diese Klasse behandelt datum vom 8. September im Jahr Meiji 1 (im gregorianischen Kalender, 8. September 1868). Obwohl der japanische Kalender im Jahr Meiji 6 (1873 des gregorianischen Kalenders) von einem Mondkalender auf einen Sonnenkalender umgestellt wurde, basiert diese Implementierung nur auf dem Sonnenkalender.

Schaltjahre im japanischen Kalender entsprechen den gleichen Schaltjahren im gregorianischen Kalender. Ein Schaltjahr im gregorianischen Kalender wird als ein gregorianisches Jahr definiert, das gleichmäßig durch vier teilbar ist, es sei denn, es ist durch 100 teilbar. Gregorianische Jahre, die durch 400 teilbar sind, sind jedoch Schaltjahre. Ein gängiges Jahr hat 365 Tage und ein Schaltjahr 366 Tage.

Der japanische Kalender hat 12 Monate mit jeweils 28 bis 31 Tagen:

GetMonth-Wert	Month (Monat)	Englisch	Tage in gemeinsamen Jahren	Tage in Schaltjahren
1	1月 (Ichigatsu)	January	31	31
2	2月 (Nigatsu)	Februar	28	29
3	3月 (Sangatsu)	März	31	31
4	4月 (Shigatsu)	April	30	30
5	5月 (Gogatsu)	May	31	31
6	6月 (Rokugatsu)	June	30	30
7	7月 (Shichigatsu)	Juli	31	31
8	8月 (Hachigatsu)	August	31	31
9	9月 (Kugatsu)	September	30	30
10	10月 (Juugatsu)	Oktober	31	31
11	11月 (Juuichigatsu)	November	30	30
12	12月 (Juunigatsu)	Dezember	31	31

Nigatsu, das dem gregorianischen Kalendermonat Februar entspricht, hat 29 Tage in Schaltjahren und 28 in gemeinsamen Jahren.

Das Datum 1. Januar 2001 n. Chr. im gregorianischen Kalender entspricht dem ersten Tag von Ichigatsu im Jahr Heisei 13 im japanischen Kalender.

Wenn der JapaneseCalendar aktuelle Kalender der japanischen Kultur ist, DateTime.Parse erkennt die Ära Abkürzungen vor dem Jahr. Die Abkürzung ist entweder die einzeichenige lateinische Alphabet-Abkürzung oder die einstellige Kanji-Abkürzung. DateTime.Parse erkennt auch entweder "1" oder Gannen (元年) als das erste Jahr einer Ära an.

Jedes CultureInfo Objekt unterstützt eine Reihe von Kalendern. Die Calendar -Eigenschaft gibt den Standardkalender für die Kultur zurück, und die OptionalCalendars -Eigenschaft gibt ein Array zurück, das alle von der Kultur unterstützten Kalender enthält. Um den von einem CultureInfoverwendeten Kalender zu ändern, legen Sie die DateTimeFormatInfo.Calendar -Eigenschaft auf einen neuen Calendarfest.

Konstruktoren

JapaneseCalendar()

Initialisiert eine neue Instanz der JapaneseCalendar-Klasse.

Felder

CurrentEra

Stellt den aktuellen Zeitraum des aktuellen Kalenders dar. Der Wert dieses Felds beträgt 0. (Geerbt von Calendar)

Eigenschaften

AlgorithmType	Ruft einen Wert ab, der angibt, ob der aktuelle Kalender ein Sonnen- oder ein Mondkalender oder eine Kombination beider Kalenderarten ist.
DaysInYearBeforeMinSupportedYear	Ruft die Anzahl der Tage im Jahr ab, das dem Jahr vorausgeht, das von der MinSupportedDateTime-Eigenschaft angegeben wird. (Geerbt von Calendar)
Eras	Ruft die Liste der Zeiträume im JapaneseCalendar ab.
IsReadOnly	Ruft einen Wert ab, der angibt, ob dieses Calendar-Objekt schreibgeschützt ist. (Geerbt von Calendar)
MaxSupportedDateTime	Ruft das späteste vom aktuellen JapaneseCalendar-Objekt unterstützte Datum und die späteste Uhrzeit ab.
MinSupportedDateTime	Ruft das früheste vom aktuellen JapaneseCalendar-Objekt unterstützte Datum und die früheste Uhrzeit ab.
TwoDigitYearMax	Ruft das letzte Jahr eines Bereichs von 100 Jahren ab, das durch eine Jahresangabe mit 2 Stellen dargestellt werden kann, oder legt dieses fest.

Methoden

AddDays(DateTime, Int32)	Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Tagen entspricht. (Geerbt von Calendar)
AddHours(DateTime, Int32)	Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Stunden entspricht. (Geerbt von Calendar)
AddMilliseconds(DateTime, Double)	Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Millisekunden entspricht. (Geerbt von Calendar)
AddMinutes(DateTime, Int32)	Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Minuten entspricht. (Geerbt von Calendar)
AddMonths(DateTime, Int32)	Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Monaten entspricht.
AddSeconds(DateTime, Int32)	Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Sekunden entspricht. (Geerbt von Calendar)
AddWeeks(DateTime, Int32)	Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Wochen entspricht. (Geerbt von Calendar)
AddYears(DateTime, Int32)	Gibt eine DateTime zurück, die dem angegebenen Zeitintervall zur angegebenen DateTime in Jahren entspricht.
Clone()	Erstellt ein neues Objekt, das eine Kopie des aktuellen Calendar-Objekts darstellt. (Geerbt von Calendar)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetDayOfMonth(DateTime)	Gibt den Tag des Monats in der angegebenen DateTime zurück.
GetDayOfWeek(DateTime)	Gibt den Wochentag in der angegebenen DateTime zurück.
GetDayOfYear(DateTime)	Gibt den Tag des Jahres im angegebenen DateTime zurück.
GetDaysInMonth(Int32, Int32)	Gibt die Anzahl der Tage im angegebenen Monat und Jahr im aktuellen Zeitraum zurück. (Geerbt von Calendar)
GetDaysInMonth(Int32, Int32, Int32)	Gibt die Anzahl der Tage im angegebenen Monat des angegebenen Jahres im angegebenen Zeitraum zurück.
GetDaysInYear(Int32)	Gibt die Anzahl der Tage im angegebenen Jahr des aktuellen Zeitraums zurück. (Geerbt von Calendar)
GetDaysInYear(Int32, Int32)	Gibt die Anzahl der Tage des angegebenen Jahres im angegebenen Zeitraum zurück.
GetEra(DateTime)	Gibt den Zeitraum in der angegebenen DateTime zurück.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetHour(DateTime)	Gibt den Stundenwert in der angegebenen DateTime zurück. (Geerbt von Calendar)
GetLeapMonth(Int32)	Berechnet den Schaltmonat für ein angegebenes Jahr. (Geerbt von Calendar)
GetLeapMonth(Int32, Int32)	Berechnet den Schaltmonat für ein angegebenes Jahr und einen angegebenen Zeitraum.
GetMilliseconds(DateTime)	Gibt den Millisekundenwert in der angegebenen DateTime zurück. (Geerbt von Calendar)
GetMinute(DateTime)	Gibt den Minutenwert in der angegebenen DateTime zurück. (Geerbt von Calendar)
GetMonth(DateTime)	Gibt den Monat in der angegebenen DateTime zurück.
GetMonthsInYear(Int32)	Gibt die Anzahl der Monate des angegebenen Jahres im aktuellen Zeitraum zurück. (Geerbt von Calendar)
GetMonthsInYear(Int32, Int32)	Gibt die Anzahl der Monate des angegebenen Jahres im angegebenen Zeitraum zurück.
GetSecond(DateTime)	Gibt den Sekundenwert in der angegebenen DateTime zurück. (Geerbt von Calendar)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Gibt die Woche des Jahres zurück, in die das Datum in der angegebenen DateTime fällt.
GetYear(DateTime)	Gibt das Jahr in der angegebenen DateTime zurück.
IsLeapDay(Int32, Int32, Int32)	Bestimmt, ob das angegebene Datum im aktuellen Zeitraum ein Schalttag ist. (Geerbt von Calendar)
IsLeapDay(Int32, Int32, Int32, Int32)	Bestimmt, ob das angegebene Datum im angegebenen Zeitraum ein Schalttag ist.
IsLeapMonth(Int32, Int32)	Bestimmt, ob der angegebene Monat des angegebenen Jahres im aktuellen Zeitraum ein Schaltmonat ist. (Geerbt von Calendar)
IsLeapMonth(Int32, Int32, Int32)	Bestimmt, ob der angegebene Monat des angegebenen Jahres im angegebenen Zeitraum ein Schaltmonat ist.
IsLeapYear(Int32)	Bestimmt, ob das angegebene Jahr im aktuellen Zeitraum ein Schaltjahr ist. (Geerbt von Calendar)
IsLeapYear(Int32, Int32)	Bestimmt, ob das angegebene Jahr im angegebenen Zeitraum ein Schaltjahr ist.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Gibt eine DateTime zurück, die auf das angegebene Datum und die angegebene Uhrzeit im aktuellen Zeitraum festgelegt ist. (Geerbt von Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Gibt eine DateTime zurück, die auf das angegebene Datum und die angegebene Uhrzeit im angegebenen Zeitraum festgelegt ist.
ToFourDigitYear(Int32)	Konvertiert das angegebene Jahr in eine vierstellige Jahresangabe, indem anhand der TwoDigitYearMax-Eigenschaft das entsprechende Jahrhundert bestimmt wird.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Calendar
• GregorianCalendar
• Calendar
• OptionalCalendars
• Arbeiten mit Kalendern