JapaneseCalendar Klasse

Referenz

Definition

Namespace:: System.Globalization

Assemblys:: mscorlib.dll, System.Globalization.Calendars.dll

Assembly:: System.Runtime.dll

Assembly:: System.Globalization.Calendars.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object

Calendar
JapaneseCalendar

Attribute: SerializableAttribute ComVisibleAttribute

Hinweise

Der japanische Kalender, der auch als Wareki-Kalender bezeichnet wird, funktioniert genau wie der gregorianische Kalender, außer dass das Jahr und die Ära unterschiedlich sind.

Hinweis

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

Der japanische Kalender erkennt eine Ära für die Herrschaft jedes Kaisers. Die beiden jüngsten Zeitalter sind die Heisei-Ära, beginnend im gregorianischen Kalenderjahr 1989 und die Reiwa-Ära, beginnend im gregorianischen Kalenderjahr 2019. Der Name der Ära wird normalerweise vor dem Jahr angezeigt. Beispielsweise ist das gregorianische Kalenderjahr 2001 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 werden Formatierungsvorgänge mit angegebenen Datums- und Uhrzeitformatzeichenfolgen wie "D", "F" und "Y", Ausgabe Gannen anstelle von "1" in der Ergebniszeichenfolge angezeigt.

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 dazu, ob Ihre Anwendungen betroffen sind, finden Sie unter Handling a new era in the Japanese calendar in .NET (Behandeln eines neuen Zeitraumes im japanischen Kalender in .NET). Informationen zum Testen Ihrer Anwendungen auf Windows Systemen, um deren Bereitschaft für den Zeitraumwechsel sicherzustellen, finden Sie unter Vorbereiten Ihrer Anwendung auf die Änderung des japanischen Zeitraumes. Informationen zu 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 Zahlen wie folgt zu:

GetEra-Wert	Era Name	Era-Abkürzung	Gregorianische Datumsangaben
5	令和 (Reiwa)	令和 (R, r)	1. Mai 2019 zur Gegenwart
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 Datumsangaben vom 8. September im Jahr Meiji 1 (im gregorianischen Kalender, 8. September 1868). Obwohl der japanische Kalender von einem Mondkalender zu einem Sonnenkalender im Jahr Meiji 6 (1873 des Gregorianischen Kalenders) gewechselt wurde, basiert diese Implementierung nur auf dem Sonnenkalender.

Schaltjahre im japanischen Kalender entsprechen demselben Schaltjahr im gregorianischen Kalender. Ein Schaltjahr im Gregorianischen Kalender wird als gregorianisches Jahr definiert, das sogar von vier teilbar ist, außer wenn es um 100 teilbar ist. Gregorianische Jahre, die von 400 teilbar sind, sind jedoch Sprungjahre. Ein allgemeines Jahr verfügt über 365 Tage und ein Schaltjahr hat 366 Tage.

Der japanische Kalender verfügt über 12 Monate mit jeweils 28 bis 31 Tagen:

GetMonth-Wert	Month (Monat)	Englisch	Tage in gemeinsamen Jahren	Tage in Sprungjahren
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, verfügt über 29 Tage während der Schaltjahre und 28 während gemeinsamer Jahre.

Das Datum vom 1. Januar 2001 A.D. im Gregorianischen Kalender entspricht dem ersten Tag von Ichigatsu im Jahr Heisei 13 im japanischen Kalender.

Wenn es JapaneseCalendar sich um den aktuellen Kalender der japanischen Kultur handelt, DateTime.Parse erkennt die Zeitalter-Abkürzungen vor dem Jahr. Die Abkürzung ist entweder die Groß-/Kleinschreibung des lateinischen Alphabets oder die Einzelzeichen-Kanji-Abkürzung. DateTime.Parse erkennt auch entweder "1" oder Gannen (元年) als erstes Jahr einer Ära.

Jedes CultureInfo Objekt unterstützt eine Reihe von Kalendern. Die Eigenschaft gibt den Standardkalender für die Kultur zurück, und die Calendar Eigenschaft gibt ein Array zurück, das OptionalCalendars alle Kalender enthält, die von der Kultur unterstützt werden. Um den von einem CultureInfoverwendeten Kalender zu ändern, legen Sie die DateTimeFormatInfo.Calendar Eigenschaft auf ein neues 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