Поделиться через


DateTimeFormatInfo.GetEraName(Int32) Метод

Определение

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

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

Параметры

era
Int32

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

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

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

Исключения

Значение 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) возвращают пустую строку ("").

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

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