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