DateTimeFormatInfo.GetEraName(Int32) Methode
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.
Gibt die Zeichenfolge zurück, die den Namen der angegebenen Ära enthält.
public:
System::String ^ GetEraName(int era);public string GetEraName(int era);member this.GetEraName : int -> stringPublic Function GetEraName (era As Integer) As StringParameter
- era
- Int32
Die ganze Zahl, die die Ära darstellt.
Gibt zurück
Eine Zeichenfolge, die den Namen der Ära enthält.
Ausnahmen
era stellt keine gültige Ära im kalender dar, der in der Calendar Eigenschaft angegeben ist.
Hinweise
Der Name der Ära ist der Name, den ein Kalender verwendet, um auf einen Zeitraum zu verweisen, der von einem festen Punkt oder Ereignis erwartet wird. Beispielsweise ist "A.D." oder "C.E." die aktuelle Ära im gregorianischen Kalender.
Die gültigen Werte era sind in der Eras Eigenschaft der entsprechenden Klasse aufgeführt, die von Calendar. Beispiel: JapaneseCalendar.Eras Zeigt eine Liste von Eras an, die von dieser Implementierung unterstützt werden.
Von Bedeutung
Ä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.
Hinweise für Aufrufer
Wenn der Kalender dargestellt TaiwanCalendar wird, aber CurrentCulture nicht "zh-TW", dann NativeCalendarName, GetEraName(Int32)und GetAbbreviatedEraName(Int32) geben Sie eine leere Zeichenfolge ("") zurück.
