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 Erhaltenki-Kalender bezeichnet wird, funktioniert genauso wie der gregorianische Kalender, mit der Ausnahme, dass jahr und era 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 Zeit für jedes 1000-Mal.) Die beiden letzten Epochen sind die Heisei-Zeit, die im gregorianischen Kalenderjahr 1989 beginnt, und die Reiwa-Zeit, die im gregorianischen Kalenderjahr 2019 beginnt. Der Name des Zeitraumes 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 Zeit als "Gannen" bezeichnet 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 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 den Zeiten Zahlen wie folgt zu:

GetEra-Wert Name des Zeitraumes Abkürzung der Zeit Gregorianische Datumsangaben
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 – (Jisho) – (T, t) 30. Juli 1912 bis 24. Dezember 1926
1 明治 (Jiji) 明 (M, m) 8. September 1868 bis 29. Juli 1912

Diese Klasse verarbeitet Datumsangaben vom 8. September im Jahr ("Im gregorianischen Kalender", 8. September 1868). Obwohl der japanische Kalender im Jahr Kardinalji 6 (1873 des gregorianischen Kalenders) von einem Mondkalender zu einem Solarkalender gewechselt wurde, basiert diese Implementierung nur auf dem Solarkalender.

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 teilbar ist, es sei denn, es ist durch 100 teilbar. Gregorianische Jahre, die durch 400 teilbar sind, sind jedoch Schaltjahre. Ein allgemeines 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 allgemeinen Jahren Tage in Schaltjahren
1 1– (Ichigatsu) January 31 31
2 2– (Nigatsu) Februar 28 29
3 3– (Sollatsu) 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– (Hachigzie) August 31 31
9 9– (Kugatsu) September 30 30
10 10– (Juugatsu) Oktober 31 31
11 11. (Juuichiguma) November 30 30
12 12– (Juunigatsu) Dezember 31 31

Nigatsu, der dem gregorianischen Kalendermonat Februar entspricht, verfügt über 29 Tage während Schaltjahren und 28 Tage in allgemeinen Jahren.

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

Wenn JapaneseCalendar der aktuelle Kalender der japanischen Kultur ist, erkennt die Abkürzungen der DateTime.Parse Zeit vor dem Jahr. Bei der Abkürzung handelt es sich entweder um die lateinische Alphabetabkürzung mit Einzelzeichen, bei der die Groß-/Kleinschreibung nicht beachtet wird, oder um die Kanji-Abkürzung mit nur einem Zeichen. DateTime.Parse erkennt auch entweder "1" oder Gannen (元 datei) als erstes Jahr einer Zeit.

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 verwendeten Kalender CultureInfo zu ändern, legen Sie die DateTimeFormatInfo.Calendar -Eigenschaft auf einen neuen Calendar fest.

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

Siehe auch