DateTimeFormatInfo.GetEraName(Int32) 메서드

정의

네임스페이스:

System.Globalization

어셈블리:

System.Runtime.dll

Source:

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

설명

연대 이름은 일정이 고정 지점 또는 이벤트에서 계산된 기간을 참조하는 데 사용하는 이름입니다. 예를 들어 "A.D." 또는 "C.E."는 그레고리오력의 현재 시대입니다.

의 era 유효한 값은 에서 Eras 파생된 적절한 클래스의 속성에 나열됩니다 Calendar. 예를 들어: JapaneseCalendar.Eras 이 구현에서 지원되는 연대 목록을 표시합니다.

중요

일본어 달력의 시대는 천황 통치 기간을 기준으로 하므로 변경되어야 합니다. 예를 들어 2019년 5월 1일은 JapaneseCalendar 및 JapaneseLunisolarCalendar에서 레이와 시대의 시작을 나타냅니다. 이러한 시대 변경 내용은 해당 달력을 사용하는 모든 애플리케이션에 영향을 줍니다. 자세한 내용과 애플리케이션이 영향을 받는지 여부를 확인하려면 .NET에서 일본 달력의 새 시대 처리를 참조하세요. Windows 시스템에서 애플리케이션을 테스트하여 시대 변화에 대한 준비 상태를 확인하는 방법에 대한 자세한 내용은 일본 시대 변화에 맞게 애플리케이션 준비를 참조하세요. 여러 시대가 있는 달력을 지원하는 .NET의 기능과 여러 연대를 지원하는 달력으로 작업할 때 모범 사례는 연대 작업을 참조하세요.

호출자 참고

달력이 로 표현 TaiwanCalendar 되지만 가 CurrentCulture "zh-TW"NativeCalendarName가 아닌 경우 , 및 GetEraName(Int32)GetAbbreviatedEraName(Int32) 는 빈 문자열("")을 반환합니다.

추가 정보

• GetEra(String)