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 mit dem Namen des angegebenen Zeitraums zurück.
public:
System::String ^ GetEraName(int era);
public string GetEraName (int era);
member this.GetEraName : int -> string
Public Function GetEraName (era As Integer) As String
Parameter
- era
- Int32
Die Ganzzahl, die den Zeitraum darstellt.
Gibt zurück
Eine Zeichenfolge mit dem Namen des Zeitraums.
Ausnahmen
era
stellt keinen gültigen Zeitraum in dem 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 Fixpunkt oder Ereignis erwartet wird. Beispielsweise ist "A.D." oder "C.E." die aktuelle Ära im gregorianischen Kalender.
Die gültigen Werte für era
werden in der Eras Eigenschaft der entsprechenden Klasse aufgeführt, die von Calendarabgeleitet wird. Beispiel: JapaneseCalendar.Eras Zeigt eine Liste von Epochen an, die von dieser Implementierung unterstützt werden.
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 die Änderung der Ära sicherzustellen, finden Sie unter Vorbereiten der Anwendung für 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.
Hinweise für Aufrufer
Wenn der Kalender durch TaiwanCalendar dargestellt wird, aber CurrentCulture nicht "zh-TW" ist, dann NativeCalendarName, GetEraName(Int32)und GetAbbreviatedEraName(Int32) gibt eine leere Zeichenfolge ("") zurück.