DateTimeFormatInfo.GetEraName(Int32) Method

Definition

지정된 연대 이름이 포함된 문자열을 반환합니다.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

Parameters

era
Int32

연대를 나타내는 정수입니다.The integer representing the era.

Returns

String

연대 이름이 포함된 문자열입니다.A string containing the name of the era.

Exceptions

eraCalendar 속성으로 지정된 달력의 유효한 연대를 나타내지 않는 경우era does not represent a valid era in the calendar specified in the Calendar property.

Remarks

연대 이름은 달력 고정된 소수점 또는 이벤트에서 말로 시간의 기간을 참조 하는 데 사용 하는 이름이입니다.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에 대 한 유효한 값은 Calendar에서 파생 된 적절 한 클래스의 Eras 속성에 나열 됩니다.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.

Important

일본어 달력의 시대는 천황 통치 기간을 기준으로 하므로 변경되어야 합니다.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. 예를 들어 2019년 5월 1일은 JapaneseCalendarJapaneseLunisolarCalendar에서 레이와 시대의 시작을 나타냅니다.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.

Notes to Callers

달력이 TaiwanCalendar로 표시 되지만 CurrentCulture "zh-cn"가 아니면 NativeCalendarName, GetEraName(Int32)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 ("").

Applies to

See also