Calendar.Eras Eigenschaft

Definition

Ruft beim Überschreiben in einer abgeleiteten Klasse die Liste der Zeiträume im aktuellen Kalender ab.When overridden in a derived class, gets the list of eras in the current calendar.

public:
 abstract property cli::array <int> ^ Eras { cli::array <int> ^ get(); };
public abstract int[] Eras { get; }
member this.Eras : int[]
Public MustOverride ReadOnly Property Eras As Integer()

Eigenschaftswert

Int32[]

Ein Array von ganzen Zahlen, das die Zeiträume im aktuellen Kalender darstellt.An array of integers that represents the eras in the current calendar.

Beispiele

Im folgenden Beispiel werden die in JapaneseCalendar.Eras enthaltenen Werte angezeigt, wenn der Heisei-Zeitraum (1989-2019) der aktuelle Zeitraum ist.The following example displays the values contained in JapaneseCalendar.Eras when the Heisei era (1989-2019) was the current era.

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

Die Zeiträume befinden sich in umgekehrter chronologischer Reihenfolge, wobei der aktuelle Zeitraum als erstes Element des Arrays und der älteste Zeitraum als letztes Element des Arrays angegeben wird.The eras are in reverse chronological order, with the current era as the first element of the array, and the oldest era as the last element of the array. Beispielsweise ist der Wert des aktuellen Zeitraums in JapaneseCalendar 4. Dies ist das erste Element des Arrays.For example, the value of the current era in JapaneseCalendar is 4, which is the first element of the array. Nur die JapaneseCalendar und die JapaneseLunisolarCalendar-Klassen unterstützen mehrere Zeiträume.Only the JapaneseCalendar and the JapaneseLunisolarCalendar classes support multiple eras.

Wichtig

Die Zeitrechnung in japanischen Kalendern basiert auf den Regierungsperioden der Kaiser und wird sich daher erwartungsgemäß ändern.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Beispiel: Der 1. Mai 2019 markiert den Beginn des Reiwa-Zeitabschnitts in den Kalendern des Typs JapaneseCalendar und JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Eine derartige Änderung der Zeitabschnitte betrifft alle Anwendungen, die diese Kalender verwenden.Such a change of era affects all applications that use these calendars. Unter Handling a new era in the Japanese calendar in .NET (Umgang mit einem neuen Zeitabschnitt im japanischen Kalender in .NET) finden Sie weiter Informationen und wie Sie bestimmen können, ob Ihre Anwendungen ebenfalls betroffen sind.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Unter Prepare your application for the Japanese era change (Vorbereiten Ihrer Anwendung für die Änderung des Zeitabschnitts im japanischen Kalender) finden Sie Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um deren Bereitschaft für die Änderung im Zeitabschnitt sicherzustellen.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Unter Arbeiten mit Zeiträumen finden Sie Informationen zu Funktionen in .NET, die Kalender mit mehreren Zeitabschnitten unterstützen, sowie bewährte Vorgehensweisen bei der Arbeit mit solchen Kalendern.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Die Klassen JapaneseCalendar und JapaneseLunisolarCalendar unterstützen mehrere Zeiträume.The JapaneseCalendar and JapaneseLunisolarCalendar classes support multiple eras. Die meisten Kalender Implementierungen unterstützen hingegen einen einzelnen Zeitraum.Most calendar implementations, on the other hand, support a single era.

Gilt für:

Siehe auch