JapaneseCalendar Klasse

Definition

Namespace:
System.Globalization
Assemblys:
mscorlib.dll, System.Globalization.Calendars.dll
Assembly:
mscorlib.dll
Assembly:
System.Globalization.Calendars.dll
Assembly:
netstandard.dll

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.

Note

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 jede Kaiserzeit. Die beiden jüngsten Epochen sind die Heisei-Ära, beginnend im gregorianischen Kalenderjahr 1989, und die Reiwa-Ära, beginnend im gregorianischen Kalenderjahr 2019. Der Name der Ära wird in der Regel 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. Formatierungsvorgänge mit angegebenen Datums- und Uhrzeitformatzeichenfolgen, z. B. "D", "F" und "Y", ausgabe Gannen anstelle von "1" in der Ergebniszeichenfolge.

Important

Ären in den japanischen Kalendern basieren auf der Herrschaft des Kaisers und werden daher voraussichtlich wechseln. Beispielsweise markierte der 1. Mai 2019 den Anfang der Reiwa-Ära in der JapaneseCalendar und JapaneseLunisolarCalendar. Eine solche Änderung des Zeitalters wirkt sich auf alle Anwendungen aus, die diese Kalender verwenden. Unter Handling a new era in the Japanese calendar in .NET (Umgang mit einem neuen Zeitabschnitt im japanischen Kalender in .NET) finden Sie weitere Informationen und wie Sie bestimmen können, ob Ihre Anwendungen ebenfalls betroffen sind. Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um ihre Bereitschaft für die Änderung der Ära sicherzustellen, finden Sie unter "Vorbereiten Ihrer Anwendung für die Änderung im japanischen Zeitalter". Features in .NET, die Kalender mit mehreren Epochen unterstützen und bewährte Methoden beim Arbeiten mit Kalendern, die mehrere Epochen unterstützen, finden Sie unter Arbeiten mit Eras.

Diese Klasse weist den Eras wie folgt Zahlen zu:

GetEra-Wert Era Name Abkürzung für Era Gregorianische Datumsangaben
5 令和 (Reiwa) 令和 (R, r) 1. Mai 2019 zur Präsentation
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) 23. Oktober 1868 bis 29. Juli 1912

Dieser Kurs behandelt Datumsangaben vom 23. Oktober im Jahr Meiji 1 (im gregorianischen Kalender, 23. Oktober 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 den gleichen Schaltjahren im gregorianischen Kalender. Ein Schaltjahr im gregorianischen Kalender wird als gregorianisches Jahr definiert, das gleichmäßig durch vier divisierbar ist, außer wenn es durch 100 divisierbar ist. Gregorianische Jahre, die von 400 dividierbar sind, sind jedoch Schaltjahre. Ein gemeinsames Jahr hat 365 Tage und ein Schaltjahr hat 366 Tage.

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

GetMonth-Wert Monat English Tage in gemeinsamen Jahren Tage in Schaltjahren
1 1月 (Ichigatsu) Januar 31 31
2 2月 (Nigatsu) Februar 28 29
3 3月 (Sangatsu) März 31 31
4 4月 (Shigatsu) April 30 30
5 5月 (Gogatsu) Mai 31 31
6 6月 (Rokugatsu) Juni 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 während Schaltjahren und 28 während gemeinsamer Jahre.

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

Wenn dies JapaneseCalendar der aktuelle Kalender der japanischen Kultur ist, DateTime.Parse erkennt die Ära Abkürzungen vor dem Jahr. Bei der Abkürzung handelt es sich entweder um die Abkürzung für ein zeichenweises lateinisches Alphabet oder um die Abkürzung für ein zeichenweises Kanji. DateTime.Parse erkennt auch entweder "1" oder Gannen (元年) als das erste Jahr einer Ära.

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

Konstruktoren

Name Beschreibung
JapaneseCalendar()

Initialisiert eine neue Instanz der JapaneseCalendar-Klasse.

Felder

Name Beschreibung
CurrentEra

Stellt die aktuelle Ära des aktuellen Kalenders dar. Der Wert dieses Felds ist 0.

(Geerbt von Calendar)

Eigenschaften

Name Beschreibung
AlgorithmType

Ruft einen Wert ab, der angibt, ob der aktuelle Kalender sonnenbasiert, mondbasiert oder eine Kombination aus beiden ist.
DaysInYearBeforeMinSupportedYear

Ruft die Anzahl der Tage im Jahr ab, die dem Jahr vorausgeht, das durch die MinSupportedDateTime Eigenschaft angegeben wird.

(Geerbt von Calendar)
Eras

Ruft die Liste der Epochen in der JapaneseCalendar.
IsReadOnly

Ruft einen Wert ab, der angibt, ob dieses Calendar Objekt schreibgeschützt ist.

(Geerbt von Calendar)
MaxSupportedDateTime

Ruft das neueste Datum und die uhrzeit, das vom aktuellen JapaneseCalendar Objekt unterstützt wird.
MinSupportedDateTime

Ruft das früheste Datum und die früheste Uhrzeit ab, die vom aktuellen JapaneseCalendar Objekt unterstützt wird.
TwoDigitYearMax

Ruft das letzte Jahr eines 100-Jahres-Bereichs ab, der durch ein 2-stelliges Jahr dargestellt werden kann, oder legt diesen fest.

Methoden

Name Beschreibung
AddDays(DateTime, Int32)

Gibt einen DateTime Wert zurück, der die angegebene Anzahl von Tagen außerhalb des angegebenen DateTimeWerts darstellt.

(Geerbt von Calendar)
AddHours(DateTime, Int32)

Gibt einen DateTime Wert zurück, der die angegebene Anzahl von Stunden außerhalb des angegebenen DateTimeWerts darstellt.

(Geerbt von Calendar)
AddMilliseconds(DateTime, Double)

Gibt einen DateTime Wert zurück, der die angegebene Anzahl von Millisekunden außerhalb des angegebenen DateTimeWerts darstellt.

(Geerbt von Calendar)
AddMinutes(DateTime, Int32)

Gibt einen DateTime Wert zurück, der die angegebene Anzahl von Minuten außerhalb des angegebenen DateTimeWerts darstellt.

(Geerbt von Calendar)
AddMonths(DateTime, Int32)

Gibt einen DateTime Wert zurück, der die angegebene Anzahl von Monaten außerhalb des angegebenen DateTimeWerts darstellt.
AddSeconds(DateTime, Int32)

Gibt einen DateTime Wert zurück, der die angegebene Anzahl von Sekunden vom angegebenen DateTimeWert entfernt ist.

(Geerbt von Calendar)
AddWeeks(DateTime, Int32)

Gibt einen DateTime Wert zurück, der die angegebene Anzahl von Wochen außerhalb des angegebenen DateTimeWerts darstellt.

(Geerbt von Calendar)
AddYears(DateTime, Int32)

Gibt eine DateTime angegebene Anzahl von Jahren zurück, die vom angegebenen Wert DateTimeentfernt sind.
Clone()

Erstellt ein neues Objekt, das eine Kopie des aktuellen Calendar Objekts ist.

(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 DateTimezurück.
GetDayOfWeek(DateTime)

Gibt den Wochentag in der angegebenen DateTimeZurück.
GetDayOfYear(DateTime)

Gibt den Tag des Jahres in der angegebenen zurück DateTime.
GetDaysInMonth(Int32, Int32, Int32)

Gibt die Anzahl der Tage im angegebenen Monat im angegebenen Jahr in der angegebenen Ära zurück.
GetDaysInMonth(Int32, Int32)

Gibt die Anzahl der Tage im angegebenen Monat und Jahr der aktuellen Ära zurück.

(Geerbt von Calendar)
GetDaysInYear(Int32, Int32)

Gibt die Anzahl der Tage im angegebenen Jahr in der angegebenen Ära zurück.
GetDaysInYear(Int32)

Gibt die Anzahl der Tage im angegebenen Jahr der aktuellen Ära zurück.

(Geerbt von Calendar)
GetEra(DateTime)

Gibt die Ära in der angegebenen DateTimezurück.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetHour(DateTime)

Gibt den Stundenwert in der angegebenen .DateTime

(Geerbt von Calendar)
GetLeapMonth(Int32, Int32)

Berechnet den Schaltmonat für ein angegebenes Jahr und eine angegebene Ära.
GetLeapMonth(Int32)

Berechnet den Schaltmonat für ein angegebenes Jahr.

(Geerbt von Calendar)
GetMilliseconds(DateTime)

Gibt den Millisekundenwert im angegebenen DateTimeWert zurück.

(Geerbt von Calendar)
GetMinute(DateTime)

Gibt den Minutenwert im angegebenen DateTimeWert zurück.

(Geerbt von Calendar)
GetMonth(DateTime)

Gibt den Monat in der angegebenen Zurück DateTime.
GetMonthsInYear(Int32, Int32)

Gibt die Anzahl der Monate im angegebenen Jahr in der angegebenen Ära zurück.
GetMonthsInYear(Int32)

Gibt die Anzahl der Monate im angegebenen Jahr in der aktuellen Ära zurück.

(Geerbt von Calendar)
GetSecond(DateTime)

Gibt den Sekundenwert in der angegebenen DateTimeZurück.

(Geerbt von Calendar)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Gibt die Woche des Jahres zurück, die das Datum in der angegebenen DateTime.
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Gibt die Woche des Jahres zurück, die das Datum im angegebenen DateTime Wert enthält.

(Geerbt von Calendar)
GetYear(DateTime)

Gibt das Jahr in der angegebenen Zurück DateTime.
IsLeapDay(Int32, Int32, Int32, Int32)

Bestimmt, ob das angegebene Datum in der angegebenen Ära ein Schalttag ist.
IsLeapDay(Int32, Int32, Int32)

Bestimmt, ob das angegebene Datum in der aktuellen Ära ein Schalttag ist.

(Geerbt von Calendar)
IsLeapMonth(Int32, Int32, Int32)

Bestimmt, ob der angegebene Monat im angegebenen Jahr in der angegebenen Ära ein Schaltmonat ist.
IsLeapMonth(Int32, Int32)

Bestimmt, ob der angegebene Monat im angegebenen Jahr in der aktuellen Ära ein Schaltmonat ist.

(Geerbt von Calendar)
IsLeapYear(Int32, Int32)

Bestimmt, ob das angegebene Jahr in der angegebenen Ära ein Schaltjahr ist.
IsLeapYear(Int32)

Bestimmt, ob das angegebene Jahr in der aktuellen Ära ein Schaltjahr ist.

(Geerbt von Calendar)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Gibt einen DateTime Wert zurück, der auf das angegebene Datum und die angegebene Uhrzeit in der angegebenen Ära festgelegt ist.
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Gibt einen DateTime Wert zurück, der auf das angegebene Datum und die angegebene Uhrzeit in der aktuellen Ära festgelegt ist.

(Geerbt von Calendar)
ToFourDigitYear(Int32)

Wandelt das angegebene Jahr mithilfe der TwoDigitYearMax Eigenschaft in ein vierstelliges Jahr um, um das entsprechende Jahrhundert zu bestimmen.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen