DateTimeFormatInfo.GetEraName(Int32) Metoda

Definice

Obor názvů:

System.Globalization

Sestavení:

System.Runtime.dll

Zdroj:

DateTimeFormatInfo.cs

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

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 éry.

Výjimky

ArgumentOutOfRangeException

era nepředstavuje platnou éru v kalendáři zadaném Calendar ve vlastnosti.

Poznámky

Název éry je název, který kalendář používá k označení časového období počítaného od 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 Eras vlastnosti příslušné třídy odvozené z Calendar. Příklad: JapaneseCalendar.Eras Zobrazí seznam ér podporovaných touto implementací.

Důležité

Éry v japonských kalendářích jsou založeny na vládě císaře, a proto se očekává, že se změní. Například 1. květen 2019 označil začátek éry Reiwa v JapaneseCalendar éře a JapaneseLunisolarCalendar. Taková změna éry ovlivní všechny aplikace, které tyto kalendáře používají. Další informace a informace o tom, jestli jsou vaše aplikace ovlivněné, najdete v tématu Zpracování nové éry v japonském kalendáři v .NET. Informace o testování aplikací v systémech Windows pro zajištění jejich připravenosti na změnu éry najdete v tématu Příprava aplikace na změnu japonské éry. Informace o funkcích 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 érami.

Poznámky pro volající

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

Viz také

• GetEra(String)