JapaneseCalendar.Eras Eigenschaft
Definition
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.
Ruft die Liste der Epochen in der JapaneseCalendar.
public:
virtual property cli::array <int> ^ Eras { cli::array <int> ^ get(); };
public override int[] Eras { get; }
member this.Eras : int[]
Public Overrides ReadOnly Property Eras As Integer()
Eigenschaftswert
Ein Array von ganzen Zahlen, die die Eras in der JapaneseCalendar.
Beispiele
Im folgenden Beispiel werden die In der Eras Eigenschaft enthaltenen Werte angezeigt.
using System;
using System.Globalization;
public class SamplesJapaneseCalendar {
public static void Main() {
// Creates and initializes a JapaneseCalendar.
JapaneseCalendar myCal = new JapaneseCalendar();
// Displays the values in the Eras property.
for ( int i = 0; i < myCal.Eras.Length; i++ ) {
Console.WriteLine( "Eras[{0}] = {1}", i, myCal.Eras[i] );
}
}
}
/*
This code produces the following output.
Eras[0] = 4
Eras[1] = 3
Eras[2] = 2
Eras[3] = 1
*/
Imports System.Globalization
Public Class SamplesJapaneseCalendar
Public Shared Sub Main()
' Creates and initializes a JapaneseCalendar.
Dim myCal As New JapaneseCalendar()
' Displays the values in the Eras property.
Dim i As Integer
For i = 0 To myCal.Eras.Length - 1
Console.WriteLine("Eras[{0}] = {1}", i, myCal.Eras(i))
Next i
End Sub
End Class
'This code produces the following output.
'
'Eras[0] = 4
'Eras[1] = 3
'Eras[2] = 2
'Eras[3] = 1
'
Hinweise
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.
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 zur Gegenwart |
| 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 |
Diese Klasse behandelt Datumsangaben vom 23. Oktober im Jahr Meiji 1 (1. Januar 1868 des gregorianischen Kalenders). 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.
Note
Wenn in Zukunft zusätzliche Eras hinzugefügt werden, können Anwendungen mehr als die erwarteten fünf Zeitalter für den japanischen Kalender aufweisen. Testen Sie Ihre Anwendungen, um sicherzustellen, dass sie in einem solchen Ereignis weiterhin funktionieren. Weitere Informationen finden Sie unter "Era Handling" für den japanischen Kalender.