次の方法で共有


JapaneseCalendar.Eras プロパティ

定義

JapaneseCalendar における時代 (年号) のリストを取得します。

public:
 virtual property cli::array <int> ^ Eras { cli::array <int> ^ get(); };
public override int[] Eras { get; }
member this.Eras : int[]
Public Overrides ReadOnly Property Eras As Integer()

プロパティ値

Int32[]

時代 (年号) を JapaneseCalendar で表す整数の配列。

次の例では、 プロパティに含まれる値を Eras 表示します。

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Creates and initializes a JapaneseCalendar.
   JapaneseCalendar^ myCal = gcnew 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->Item[0] = 4
Eras->Item[1] = 3
Eras->Item[2] = 2
Eras->Item[3] = 1

*/
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

*/
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

End Class

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

注釈

和暦では、天皇の代ごとに 1 つの時代 (年号) を認識します。 2つの最新の時代は、グレゴリオ暦1989年から始まる平成時代と、2019年のグレゴリオ暦から始まるレイワ時代です。 元号の名前は通常、年の前に表示されます。 たとえば、グレゴリオ暦の 2001 年は和暦の平成 13 年です。 時代の最初の年は"元年" と呼ばれることに注意してください。したがって、グレゴリオ暦年1989年は日本の暦年平成元年でした。

重要

和暦の時代 (年号) は天皇の代に基づいているため、変更されることが予想されます。 たとえば、JapaneseCalendarJapaneseLunisolarCalendar において、2019 年 5 月 1 日から令和時代が始まることになりました。 このような時代 (年号) の変更は、これらのカレンダーを使用するすべてのアプリケーションに影響します。 詳細と、アプリケーションが影響を受けるかどうかを判断するには、「 .NET での日本語カレンダーでの新しい時代 (年号の処理)」を参照してください。 Windows システムでアプリケーションをテストして時代 (年号) の変更に対する準備を確認する方法については、「 日本の時代 (年号) の変更に備える」を参照してください。 複数の時代 (年号) を含むカレンダーをサポートする .NET の機能と、複数の時代 (年号) をサポートするカレンダーを使用する場合のベスト プラクティスについては、「 年号の使用」を参照してください。

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

GetEra 値 時代 (年号) 時代 (年号) の省略形 グレゴリオ暦の日付
5 令和 (レイワ) 令和 (R, r) 2019 年 5 月 1日から現在まで
4 平成 (Heisei) 平 (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 明治 (Meiji) 明 (M, m) 1868 年 9 月 8 日から 1912 年 7 月 29 日まで

明治1年(1868年1月1日グレゴリオ暦)の9月8日の日付を扱います。 和暦は明治 6 年 (グレゴリオ暦の 1873 年) に太陰暦から太陽暦に切り替わりましたが、この実装は太陽暦のみに基づいています。

注意

今後、時代 (年号) を追加する場合、アプリケーションでは、日本のカレンダーで予想される 5 年間を超える年号が発生する可能性があります。 アプリケーションは、このようなイベントで引き続き動作することを確認するためにテストする必要があります。 「日本語カレンダーの時代処理」を参照してください。

適用対象

こちらもご覧ください