DateTimeFormatInfo.GetEraName(Int32) Метод

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Исходный код:

DateTimeFormatInfo.cs

Возвращает строку, содержащую название указанной эры.

C#

public string GetEraName (int era);

Параметры

era

Int32

Целое число, представляющее собой эру.

Возвращаемое значение

String

Строка, содержащая название эры.

Исключения

ArgumentOutOfRangeException

Значение era не является допустимым значением эры в календаре, определенном в свойстве Calendar.

Комментарии

Имя эры — это имя, которое календарь использует для обозначения периода времени, отсчитываемого от фиксированной точки или события. Например, "Н.Э." или "C.E." — это текущая эпоха в григорианском календаре.

Допустимые значения для era перечислены в свойстве Eras соответствующего класса, производного от Calendar. Например: JapaneseCalendar.Eras отображает список эр, поддерживаемых этой реализацией.

Важно!

Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва. Изменение эры затрагивает все приложения, использующие эти календари. Дополнительные сведения и определение того, затронуты ли приложения, см. в статье Обработка новой эры в японском календаре в .NET. Сведения о тестировании приложений в системах Windows для обеспечения их готовности к изменению эры см. в статье Подготовка приложения к изменению японской эры. Сведения о функциях в .NET, поддерживающих календари с несколькими эрами, а также рекомендации по работе с календарями, поддерживающими несколько эпох, см. в статье Работа с эрами.

Примечания для тех, кто вызывает этот метод

Если календарь представлен, TaiwanCalendar но CurrentCulture не является "zh-TW", то NativeCalendarName, GetEraName(Int32)и GetAbbreviatedEraName(Int32) возвращают пустую строку ("").

Применяется к

См. также раздел

• GetEra(String)