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.

예외

eraCalendar 속성으로 지정된 달력의 유효한 연대를 나타내지 않는 경우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. 예를 들어 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.

호출자 참고

달력은 표현 하는 경우 TaiwanCalendar 되지만 CurrentCulture "ZH-TW" 다음 아닙니다 NativeCalendarNameGetEraName(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 ("").

적용 대상

추가 정보