Freigeben über


DateTimeFormatInfo.GetEraName(Int32) Methode

Definition

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.

Gilt für:

Weitere Informationen