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.
Комментарии
Название эры — это имя, которое календарь использует для ссылки на период времени, недюжинной с фиксированной точки или события. Например, «н. э.» или «Н.Э.» Текущая эра григорианского календаря.
Допустимые значения для указаны era
в Eras свойстве соответствующего класса, производного от Calendar . Например: JapaneseCalendar.Eras отображает список Эр, поддерживаемых этой реализацией.
Важно!
Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва. Изменение эры затрагивает все приложения, использующие эти календари. Дополнительные сведения и определение того, затрагиваются ли ваши приложения, см. в разделе Обработка новой эры в японском календаре в .NET. сведения о тестировании приложений на Windows системах для обеспечения их готовности к изменению эры см. в разделе подготовка приложения к изменению японской эры. Дополнительные сведения о функциях .NET, поддерживающих календари с несколькими Эр, и рекомендации при работе с календарями, поддерживающими несколько эр, см. в разделе Работа с Эр.
Примечания для тех, кто вызывает этот метод
Если календарь представлен, TaiwanCalendar но CurrentCulture не является "zh-TW", NativeCalendarName GetEraName(Int32) и GetAbbreviatedEraName(Int32) возвращает пустую строку ("").