DateTimeFormatInfo.GetEraName(Int32) Metoda

  • Reference

Definice

Obor názvů:
System.Globalization
Sestavení:
System.Globalization.dll
Sestavení:
System.Runtime.dll
Sestavení:
netstandard.dll
Sestavení:
mscorlib.dll

Vrátí řetězec obsahující název zadaného období.

public:
 System::String ^ GetEraName(int era);
public string GetEraName (int era);
member this.GetEraName : int -> string
Public Function GetEraName (era As Integer) As String

Parametry

era
Int32

Celé číslo představující éru.

Návraty

String

Řetězec obsahující název období.

Výjimky

ArgumentOutOfRangeException

era nepředstavuje platné období v kalendáři zadaném ve Calendar vlastnosti .

Poznámky

Název období je název, který kalendář používá k odkazování na časové období zachované z pevného bodu nebo události. Například "A.D." nebo "C.E." je aktuální éra v gregoriánském kalendáři.

Platné hodnoty pro era jsou uvedeny ve vlastnosti příslušné třídy odvozené z Eras Calendar . Příklad: JapaneseCalendar.Eras zobrazí seznam období podporovaných touto implementací.

Důležité

Éra v japonském kalendáři jsou založená na tom, jak zavládá, a proto se očekává, že se změní. Například 1. května 2019 bylo označeno začátek éry remu v a JapaneseCalendar JapaneseLunisolarCalendar . Taková změna éry ovlivní všechny aplikace, které tyto kalendáře používají. Další informace a informace o tom, zda jsou ovlivněny vaše aplikace, najdete v tématu Zpracování nové éry v japonském kalendáři v rozhraní .NET. Informace o testování aplikací v systémech Windows, abyste zajistili jejich připravenost na změnu období, najdete v tématu Příprava aplikace na změnu v japonském období. Funkce v .NET, které podporují kalendáře s více érami, a osvědčené postupy při práci s kalendáři, které podporují více ér, najdete v tématu Práce s obdobími.

Poznámky pro volající

Pokud je kalendář reprezentován , ale není TaiwanCalendar CurrentCulture "zh-TW", pak , a vrátí NativeCalendarName GetEraName(Int32) prázdný řetězec GetAbbreviatedEraName(Int32) ("").

Platí pro

Viz také