DateTimeFormatInfo.GetAbbreviatedEraName-Methode

Artikel
08/20/2007

Gibt die Zeichenfolge zurück, die den abgekürzten Namen des angegebenen Zeitraums enhält, sofern eine Abkürzung vorhanden ist.

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function GetAbbreviatedEraName ( _
    era As Integer _
) As String
'Usage
Dim instance As DateTimeFormatInfo
Dim era As Integer
Dim returnValue As String

returnValue = instance.GetAbbreviatedEraName(era)

public string GetAbbreviatedEraName (
    int era
)

public:
String^ GetAbbreviatedEraName (
    int era
)

public String GetAbbreviatedEraName (
    int era
)

public function GetAbbreviatedEraName (
    era : int
) : String

Parameter

era
Die Ganzzahl, die den Zeitraum darstellt.

Rückgabewert

Eine Zeichenfolge, die den abgekürzten Namen des angegebenen Zeitraums enhält, sofern eine Abkürzung vorhanden ist. – oder – Eine Zeichenfolge, die den vollständigen Namen des Zeitraums enhält, sofern keine Abkürzung vorhanden ist.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	era stellt keinen gültigen Zeitraum in dem Kalender dar, der in der Calendar-Eigenschaft angegeben ist.

Hinweise

Der Name des Zeitraums ist der Name, der in einem Kalender für eine Zeitspanne verwendet wird, die von einem festgelegten Zeitpunkt oder Ereignis an gerechnet wird. Beispielsweise bezeichnet "A.D." bzw. "u.Z." den aktuellen Zeitraum im gregorianischen Kalender.

Die gültigen Werte für era sind in der Eras-Eigenschaft der entsprechenden Klasse aufgelistet, die von Calendar abgeleitet ist. JapaneseCalendar.Eras zeigt beispielsweise eine Liste von Zeiträumen an, die von dieser Implementierung unterstützt werden.

Im JapaneseCalendar wird das erste Zeichen des vollständigen Namens für die Abkürzung des Zeitraums verwendet, d. h. entweder die aus einem Buchstaben bestehende, von der Groß- und Kleinschreibung unabhängige Abkürzung im lateinischen Alphabet oder die aus einem Kanji-Zeichen bestehende Abkürzung.

Hinweise für Aufrufer Wenn DateTimeFormatInfo.Calendar der TaiwanCalendar ist, die Thread.CurrentCulture jedoch nicht "zh-TW" ist, geben NativeCalendarName, GetEraName und GetAbbreviatedEraName eine leere Zeichenfolge zurück ("").

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DateTimeFormatInfo-Klasse
DateTimeFormatInfo-Member
System.Globalization-Namespace
JapaneseCalendar
TaiwanCalendar

Freigeben über