JapaneseCalendar.GetEra メソッド

指定した DateTime の時代 (年号) を返します。

Overrides Public Function GetEra( _
   ByVal time As DateTime _) As Integer
[C#]
public override int GetEra(DateTimetime);
[C++]
public: int GetEra(DateTimetime);
[JScript]
public override function GetEra(
   time : DateTime) : int;

パラメータ

• time
  読み取る対象の DateTime 。

戻り値

指定した DateTime の時代 (年号) を表す整数。

解説

和暦では、天皇の在位期間ごとに 1 つの元号が認識されます。現在の時代 (年号) は、グレゴリオ暦の 1989 年から始まる平成です。通常、時代 (年号) 名は年の前に表示されます。たとえば、グレゴリオ暦の 2001 年は、和暦では平成 13 年です。ある元号の最初の年を "元年" と呼ぶため、グレゴリオ暦の 1989 年は、和暦では平成元年となります。

このクラスは、次のように時代 (年号) に番号を割り当てます。

このクラスは、明治 1 年の 9 番目の月の 8 番目の日 (グレゴリオ暦で 1868 年の 9 月 8 日) 以降の日付だけを処理します。和暦は明治 6 年 (グレゴリオ暦の 1873 年) に太陰暦から太陽暦に切り替えられましたが、この実装は太陽暦だけに基づいています。

使用例

[Visual Basic, C#, C++] DateTime のいくつかのコンポーネントの値を和暦で表示する例を次に示します。

 
Imports System
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 'Main

   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 'DisplayValues

End Class 'SamplesJapaneseCalendar 


'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


[C#] 
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

*/

[C++] 
#using <mscorlib.dll>
using namespace System;
using namespace System::Globalization;

void DisplayValues( Calendar* myCal, DateTime myDT )  {
   Console::WriteLine( S"   Era:        {0}", __box(myCal->GetEra( myDT )));
   Console::WriteLine( S"   Year:       {0}", __box(myCal->GetYear( myDT )));
   Console::WriteLine( S"   Month:      {0}", __box(myCal->GetMonth( myDT )));
   Console::WriteLine( S"   DayOfYear:  {0}", __box(myCal->GetDayOfYear( myDT )));
   Console::WriteLine( S"   DayOfMonth: {0}", __box(myCal->GetDayOfMonth( myDT )));
   Console::WriteLine( S"   DayOfWeek:  {0}", __box(myCal->GetDayOfWeek( myDT )));
   Console::WriteLine();
}

int main()  {

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

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

   // Displays the values of the DateTime.
   Console::WriteLine( S"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( S"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

*/

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

JapaneseCalendar クラス | JapaneseCalendar メンバ | System.Globalization 名前空間 | System.DateTime | CurrentEra | Eras | GetYear | GetMonth | GetDayOfYear | GetDayOfMonth | GetDayOfWeek | Calendar.GetWeekOfYear | Calendar.GetHour | Calendar.GetMinute | Calendar.GetSecond | Calendar.GetMilliseconds