DateTimeFormatInfo.GetEraName(Int32) Methode

Definition

Gibt die Zeichenfolge mit dem Namen des angegebenen Zeitraums zurück.Returns the string containing the name of the specified era.

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.The integer representing the era.

Gibt zurück

Eine Zeichenfolge mit dem Namen des Zeitraums.A string containing the name of the era.

Ausnahmen

era stellt keinen gültigen Zeitraum in dem Kalender dar, der in der Calendar-Eigenschaft angegeben ist.era does not represent a valid era in the calendar specified in the Calendar property.

Hinweise

Der Era-Name ist der Name, den ein Kalender verwendet, um auf einen Zeitraum zu verweisen, der von einem bestimmten Punkt oder Ereignis abgerechnet wird.The era name is the name a calendar uses to refer to a period of time reckoned from a fixed point or event. Beispiel: "A.D."For example, "A.D." oder "or "C.E." der aktuelle Zeitraum im gregorianischen Kalender.is the current era in the Gregorian calendar.

Die gültigen Werte für era sind in der Eras -Eigenschaft der entsprechenden, von Calendarabgeleiteten Klasse aufgeführt.The valid values for era are listed in the Eras property of the appropriate class derived from Calendar. Beispiel: JapaneseCalendar.Eras zeigt eine Liste von Epochen an, die von dieser Implementierung unterstützt werden.For example: JapaneseCalendar.Eras displays a list of eras that are supported by this implementation.

Wichtig

Die Zeitrechnung in japanischen Kalendern basiert auf den Regierungsperioden der Kaiser und wird sich daher erwartungsgemäß ändern.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Beispiel: Der 1. Mai 2019 markiert den Beginn des Reiwa-Zeitabschnitts in den Kalendern des Typs JapaneseCalendar und JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Eine derartige Änderung der Zeitabschnitte betrifft alle Anwendungen, die diese Kalender verwenden.Such a change of era affects all applications that use these calendars. Unter Handling a new era in the Japanese calendar in .NET (Umgang mit einem neuen Zeitabschnitt im japanischen Kalender in .NET) finden Sie weiter Informationen und wie Sie bestimmen können, ob Ihre Anwendungen ebenfalls betroffen sind.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Unter Prepare your application for the Japanese era change (Vorbereiten Ihrer Anwendung für die Änderung des Zeitabschnitts im japanischen Kalender) finden Sie Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um deren Bereitschaft für die Änderung im Zeitabschnitt sicherzustellen.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Unter Arbeiten mit Zeiträumen finden Sie Informationen zu Funktionen in .NET, die Kalender mit mehreren Zeitabschnitten unterstützen, sowie bewährte Vorgehensweisen bei der Arbeit mit solchen Kalendern.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Hinweise für Aufrufer

Wenn der TaiwanCalendar Kalender durch dargestellt wird, CurrentCulture aber nicht "zh NativeCalendarName- GetEraName(Int32)TW" ist, geben, und GetAbbreviatedEraName(Int32) eine leere Zeichenfolge ("") zurück.If the calendar is represented by TaiwanCalendar but the CurrentCulture is not "zh-TW", then NativeCalendarName, GetEraName(Int32), and GetAbbreviatedEraName(Int32) return an empty string ("").

Gilt für:

Siehe auch