Export (0) Print
Expand All

JapaneseCalendar.Eras Property

Gets the list of eras in the JapaneseCalendar.

[Visual Basic]
Overrides Public ReadOnly Property Eras As Integer ()
[C#]
public override int[] Eras {get;}
[C++]
public: __property int get_Eras();
[JScript]
public override function get Eras() : int[];

Property Value

An array of integers that represents the eras in the JapaneseCalendar.

Remarks

The Japanese calendar recognizes one era for every emperor's reign. The current era is the Heisei era, which began in the Gregorian calendar year 1989. The era name is typically displayed before the year. For example, the Gregorian calendar year 2001 is the Japanese calendar year Heisei 13. Note that the first year of an era is called "Gannen"; therefore, the Gregorian calendar year 1989 was the Japanese calendar year Heisei Gannen.

This class assigns numbers to the eras as follows:

GetEra value Era Name Era Abbreviation Gregorian Dates
4 平成 (Heisei) 平 (H, h) January 8, 1989 to present
3 昭和 (Showa) 昭 (S, s) December 25, 1926 to January 7, 1989
2 大正 (Taisho) 大 (T, t) July 30, 1912 to December 24, 1926
1 明治 (Meiji) 明 (M, m) September 8, 1868 to July 29, 1912

This class only handles dates from the eighth day of the ninth month in the year Meiji 1 (September 8, 1868 of the Gregorian calendar). Although the Japanese calendar was switched from a lunar calendar to a solar calendar in the year Meiji 6 (1873 of the Gregorian calendar), this implementation is based on the solar calendar only.

Example

[Visual Basic, C#, C++] The following code example displays the values contained in the Eras property.

[Visual Basic] 
Imports System
Imports System.Globalization

Public Class SamplesJapaneseCalendar

   Public Shared Sub Main()

      ' Creates and initializes a JapaneseCalendar.
      Dim myCal As New JapaneseCalendar()

      ' Displays the values in the Eras property.
      Dim i As Integer
      For i = 0 To myCal.Eras.Length - 1
         Console.WriteLine("Eras[{0}] = {1}", i, myCal.Eras(i))
      Next i

   End Sub 'Main 

End Class 'SamplesJapaneseCalendar

'This code produces the following output.
'
'Eras[0] = 4
'Eras[1] = 3
'Eras[2] = 2
'Eras[3] = 1
'

[C#] 
using System;
using System.Globalization;


public class SamplesJapaneseCalendar  {

   public static void Main()  {

      // Creates and initializes a JapaneseCalendar.
      JapaneseCalendar myCal = new JapaneseCalendar();

      // Displays the values in the Eras property.
      for ( int i = 0; i < myCal.Eras.Length; i++ )  {
         Console.WriteLine( "Eras[{0}] = {1}", i, myCal.Eras[i] );
      }

   }

}

/*
This code produces the following output.

Eras[0] = 4
Eras[1] = 3
Eras[2] = 2
Eras[3] = 1

*/

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

int main()
{
   // Creates and initializes a JapaneseCalendar.
   JapaneseCalendar* myCal = new JapaneseCalendar();

   // Displays the values in the Eras property.
   for (int i = 0; i < myCal -> Eras -> Length; i++)
   {
      Console::WriteLine(S"Eras[ {0}] = {1}", __box(i), __box(myCal -> Eras[i]));
   }
}

/*
This code produces the following output.

Eras->Item[0] = 4
Eras->Item[1] = 3
Eras->Item[2] = 2
Eras->Item[3] = 1

*/

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

JapaneseCalendar Class | JapaneseCalendar Members | System.Globalization Namespace | CurrentEra

Show:
© 2015 Microsoft