DateTimeFormatInfo.GetEraName(Int32) Methode

Referenz

Definition

Namespace:: System.Globalization

Assembly:: System.Globalization.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: DateTimeFormatInfo.cs

Quelle:: DateTimeFormatInfo.cs

Quelle:: DateTimeFormatInfo.cs

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

String

Eine Zeichenfolge mit dem Namen des Zeitraums.

Ausnahmen

ArgumentOutOfRangeException

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

GetEra(String)