Freigeben über


JapaneseCalendar Klasse

Definition

Stellt den japanischen Kalender dar.

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
Vererbung
JapaneseCalendar
Attribute

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.

AlgorithmType

Ruft einen Wert ab, der angibt, ob der aktuelle Kalender ein Sonnen- oder ein Mondkalender oder eine Kombination beider Kalenderarten ist.

(Geerbt von Calendar)
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.

MaxSupportedDateTime

Ruft das späteste von diesem Calendar-Objekt unterstützte Datum und die späteste Uhrzeit ab.

(Geerbt von Calendar)
MinSupportedDateTime

Ruft das früheste vom aktuellen JapaneseCalendar-Objekt unterstützte Datum und die früheste Uhrzeit ab.

MinSupportedDateTime

Ruft das früheste von diesem Calendar-Objekt unterstützte Datum und die früheste Uhrzeit ab.

(Geerbt von Calendar)
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.

GetLeapMonth(Int32, Int32)

Berechnet den Schaltmonat für ein angegebenes Jahr und einen angegebenen Zeitraum.

(Geerbt von Calendar)
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.

GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Gibt die Woche des Jahrs zurück, in die das Datum im angegebenen DateTime-Wert fällt.

(Geerbt von Calendar)
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)

Gilt für:

Weitere Informationen