Calendar.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.
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Liste der Eras im aktuellen Kalender ab.
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
Ein Array von ganzzahligen Zahlen, die die Eras im aktuellen Kalender darstellen.
Beispiele
Im folgenden Beispiel werden die Werte angezeigt, in JapaneseCalendar.Eras denen die Heisei-Ära (1989-2019) die aktuelle Ära war.
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 Epochen befinden sich in umgekehrter chronologischer Reihenfolge, wobei die aktuelle Ära als erstes Element des Arrays und die älteste Ära als letztes Element des Arrays gilt. Der Wert der aktuellen Ära in JapaneseCalendar "4" ist z. B. das erste Element des Arrays. Nur die JapaneseCalendar Klassen und die JapaneseLunisolarCalendar Klassen unterstützen mehrere Epochen.
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.
Die JapaneseCalendar Klassen JapaneseLunisolarCalendar unterstützen mehrere Epochen. Die meisten Kalenderimplementierungen unterstützen dagegen ein einzelnes Zeitalter.