JapaneseCalendar.GetEra(DateTime) 메서드

정의

네임스페이스:

System.Globalization

어셈블리:

System.Runtime.dll

Source:

JapaneseCalendar.cs

지정된 DateTime의 연대를 반환합니다.

public:
 override int GetEra(DateTime time);

public override int GetEra (DateTime time);

override this.GetEra : DateTime -> int

Public Overrides Function GetEra (time As DateTime) As Integer

매개 변수

time

DateTime

읽을 DateTime입니다.

반환

Int32

지정된 DateTime의 연대를 나타내는 정수입니다.

예외

ArgumentOutOfRangeException

결과 DateTime이 지원되는 범위 밖에 있는 경우

예제

다음 예제에서는 일본어 달력을 기준으로 의 여러 구성 요소 DateTime 값을 표시합니다.

using namespace System;
using namespace System::Globalization;
void DisplayValues( Calendar^ myCal, DateTime myDT )
{
   Console::WriteLine( "   Era:        {0}", myCal->GetEra( myDT ) );
   Console::WriteLine( "   Year:       {0}", myCal->GetYear( myDT ) );
   Console::WriteLine( "   Month:      {0}", myCal->GetMonth( myDT ) );
   Console::WriteLine( "   DayOfYear:  {0}", myCal->GetDayOfYear( myDT ) );
   Console::WriteLine( "   DayOfMonth: {0}", myCal->GetDayOfMonth( myDT ) );
   Console::WriteLine( "   DayOfWeek:  {0}", myCal->GetDayOfWeek( myDT ) );
   Console::WriteLine();
}

int main()
{
   
   // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
   DateTime myDT = DateTime(2002,4,3,gcnew GregorianCalendar);
   
   // Creates an instance of the JapaneseCalendar.
   JapaneseCalendar^ myCal = gcnew JapaneseCalendar;
   
   // Displays the values of the DateTime.
   Console::WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:" );
   DisplayValues( myCal, myDT );
   
   // Adds two years and ten months.
   myDT = myCal->AddYears( myDT, 2 );
   myDT = myCal->AddMonths( myDT, 10 );
   
   // Displays the values of the DateTime.
   Console::WriteLine( "After adding two years and ten months:" );
   DisplayValues( myCal, myDT );
}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:
   Era:        4
   Year:       14
   Month:      4
   DayOfYear:  93
   DayOfMonth: 3
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        4
   Year:       17
   Month:      2
   DayOfYear:  34
   DayOfMonth: 3
   DayOfWeek:  Thursday

*/

using System;
using System.Globalization;

public class SamplesJapaneseCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Creates an instance of the JapaneseCalendar.
      JapaneseCalendar myCal = new JapaneseCalendar();

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:" );
      DisplayValues( myCal, myDT );

      // Adds two years and ten months.
      myDT = myCal.AddYears( myDT, 2 );
      myDT = myCal.AddMonths( myDT, 10 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding two years and ten months:" );
      DisplayValues( myCal, myDT );
   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:        {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:       {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:      {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:  {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth: {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:  {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:
   Era:        4
   Year:       14
   Month:      4
   DayOfYear:  93
   DayOfMonth: 3
   DayOfWeek:  Wednesday

After adding two years and ten months:
   Era:        4
   Year:       17
   Month:      2
   DayOfYear:  34
   DayOfMonth: 3
   DayOfWeek:  Thursday

*/

Imports System.Globalization


Public Class SamplesJapaneseCalendar   

   Public Shared Sub Main()

      ' Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      Dim myDT As New DateTime(2002, 4, 3, New GregorianCalendar())

      ' Creates an instance of the JapaneseCalendar.
      Dim myCal As New JapaneseCalendar()

      ' Displays the values of the DateTime.
      Console.WriteLine("April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:")
      DisplayValues(myCal, myDT)

      ' Adds two years and ten months.
      myDT = myCal.AddYears(myDT, 2)
      myDT = myCal.AddMonths(myDT, 10)

      ' Displays the values of the DateTime.
      Console.WriteLine("After adding two years and ten months:")
      DisplayValues(myCal, myDT)

   End Sub

   Public Shared Sub DisplayValues(myCal As Calendar, myDT As DateTime)
      Console.WriteLine("   Era:        {0}", myCal.GetEra(myDT))
      Console.WriteLine("   Year:       {0}", myCal.GetYear(myDT))
      Console.WriteLine("   Month:      {0}", myCal.GetMonth(myDT))
      Console.WriteLine("   DayOfYear:  {0}", myCal.GetDayOfYear(myDT))
      Console.WriteLine("   DayOfMonth: {0}", myCal.GetDayOfMonth(myDT))
      Console.WriteLine("   DayOfWeek:  {0}", myCal.GetDayOfWeek(myDT))
      Console.WriteLine()
   End Sub

End Class


'This code produces the following output.
'
'April 3, 2002 of the Gregorian calendar equals the following in the Japanese calendar:
'   Era:        4
'   Year:       14
'   Month:      4
'   DayOfYear:  93
'   DayOfMonth: 3
'   DayOfWeek:  Wednesday
'
'After adding two years and ten months:
'   Era:        4
'   Year:       17
'   Month:      2
'   DayOfYear:  34
'   DayOfMonth: 3
'   DayOfWeek:  Thursday

설명

일본 달력은 모든 황제의 통치에 대한 하나의 시대를 인식합니다. 가장 최근의 두 시대는 1989년 그레고리오력에서 시작된 헤이세이 시대와 2019년 그레고리오력부터 시작되는 레이와 시대입니다. 시대 이름은 일반적으로 연도 전에 표시됩니다. 예를 들어 2001년 그레고리오력은 일본 달력의 해인 Heisei 13입니다. 시대의 첫 해는 "Gannen"이라고 합니다. 따라서 1989년 그레고리오력은 일본 달력인 헤이세이 가넨이었습니다.

중요

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

이 클래스는 다음과 같이 연대에 숫자를 할당합니다.

GetEra 값	Era 이름	시대 약어	그레고리오 날짜
5	令れ(레이와)	令れ (R, r)	2019년 5월 1일 발표
4	成(헤이세이)	( H, h)	1989년 1월 8일~2019년 4월 30일
3	昭れ (Showa)	昭(S, s)	1926년 12월 25일~1989년 1월 7일
2	囙(타이쇼)	( T, t)	1912년 7월 30일~1926년 12월 24일
1	明治(메이지)	明(M, m)	1868년 9월 8일~1912년 7월 29일

일반적으로 클래스는 JapaneseCalendar 속성 값 MinSupportedDateTime 인 Meiji 1(1868년 9월 8일)의 9월 8일부터 날짜를 지원합니다. 그러나 GetEra 이 방법은 메이지 1년(1868년 1월 1일~1868년 9월 7일 양력)의 1월 1일부터 9월 7일까지의 날짜에 대한 시대를 성공적으로 반환합니다. 그레고리오력에서 1868년 1월 1일 이전 날짜의 경우 메서드는 예외를 ArgumentOutOfRangeException throw합니다.

추가 정보

• DateTime
• CurrentEra
• Eras
• GetYear(DateTime)
• GetMonth(DateTime)
• GetDayOfYear(DateTime)
• GetDayOfMonth(DateTime)
• GetDayOfWeek(DateTime)
• GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)
• GetHour(DateTime)
• GetMinute(DateTime)
• GetSecond(DateTime)
• GetMilliseconds(DateTime)