DateTimeFormatInfo.GetEraName(Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает строку, содержащую название указанной эры.
public:
System::String ^ GetEraName(int era);public string GetEraName (int era);member this.GetEraName : int -> stringPublic 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) возвращают пустую строку ("").
