JapaneseCalendar.Eras Eigenschaft

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Quelle:

JapaneseCalendar.cs

Ruft die Liste der Zeiträume im JapaneseCalendar ab.

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

Int32[]

Ein Array von ganzen Zahlen, das die Zeiträume im JapaneseCalendar darstellt.

Beispiele

Im folgenden Beispiel werden die in der Eras -Eigenschaft enthaltenen Werte angezeigt.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Creates and initializes a JapaneseCalendar.
   JapaneseCalendar^ myCal = gcnew 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->Item[0] = 4
Eras->Item[1] = 3
Eras->Item[2] = 2
Eras->Item[3] = 1

*/

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 die Herrschaft jedes Kaisers an. 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 des Zeitraums 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.

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 den Zeitwechsel sicherzustellen, finden Sie unter Vorbereiten ihrer Anwendung auf 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 des Zeitraums	Era Abkürzung	Gregorianische Daten
5	令和 (Reiwa)	令和 (R, r)	1. Mai 2019 bis heute
4	平成 (Heisei)	平 (H, h)	8. Januar 1989 bis heute
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

Dieser Kurs behandelt Datumsangaben vom 8. September im Jahr Meiji 1 (1. Januar 1868 des gregorianischen Kalenders). 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.

Hinweis

Sollten in Zukunft weitere Zeiträume hinzugefügt werden, können Anwendungen mehr als die erwarteten fünf Epochen für den japanischen Kalender aufweisen. Ihre Anwendungen sollten getestet werden, um sicherzustellen, dass sie in einem solchen Fall weiterhin funktionieren. siehe Era Handling für den japanischen Kalender.

Weitere Informationen

• CurrentEra