DateTimeFormatInfo.GetEraName(Int32) DateTimeFormatInfo.GetEraName(Int32) DateTimeFormatInfo.GetEraName(Int32) DateTimeFormatInfo.GetEraName(Int32) Method

Определение

Возвращает строку, содержащую название указанной эры.Returns the string containing the name of the specified era.

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 Int32 Int32 Int32

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

Возвраты

Строка, содержащая название эры.A string containing the name of the era.

Исключения

Значение era не является допустимым значением эры в календаре, определенном в свойстве Calendar.era does not represent a valid era in the calendar specified in the Calendar property.

Комментарии

Название эры — это имя, которое календарь использует для ссылки на период времени, недюжинной с фиксированной точки или события.The era name is the name a calendar uses to refer to a period of time reckoned from a fixed point or event. Например, «н. э.»For example, "A.D." или «Н.Э.»or "C.E." Текущая эра григорианского календаря.is the current era in the Gregorian calendar.

Допустимые значения для era указаны Eras в свойстве соответствующего класса, производного от Calendar.The valid values for era are listed in the Eras property of the appropriate class derived from Calendar. Например: JapaneseCalendar.Eras отображает список Эр, поддерживаемых этой реализацией.For example: JapaneseCalendar.Eras displays a list of eras that are supported by this implementation.

Важно!

Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Изменение эры затрагивает все приложения, использующие эти календари.Such a change of era affects all applications that use these calendars. Из раздела Обработка новой эры по японскому календарю в .NET можно почерпнуть дополнительные сведения, а также узнать, затронуты ли ваши приложения этим изменением.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Сведения о тестировании приложений в системах Windows для обеспечения их готовности к работе в новой эре см. в разделе Подготовка приложения к изменению эры по японскому календарю.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Сведения о функциях в .NET, которые поддерживают календарь с несколькими эрами, и рекомендации по использованию таких календарей см. в разделе о работе с эрами.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Примечания для тех, кто вызывает этот метод

Если календарь TaiwanCalendar представлен, CurrentCulture но не является "zh NativeCalendarName- GetEraName(Int32)TW", и GetAbbreviatedEraName(Int32) возвращает пустую строку ("").If the calendar is represented by TaiwanCalendar but the CurrentCulture is not "zh-TW", then NativeCalendarName, GetEraName(Int32), and GetAbbreviatedEraName(Int32) return an empty string ("").

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

Дополнительно