DateTimeFormatInfo.GetEraName(Int32) Метод

Ссылка

Определение

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

Сборка:: System.Globalization.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Исходный код:: DateTimeFormatInfo.cs

Исходный код:: DateTimeFormatInfo.cs

Исходный код:: DateTimeFormatInfo.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

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

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

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)