Calendar.Eras Calendar.Eras Calendar.Eras Calendar.Eras Property

定義

派生クラスでオーバーライドされると、現在のカレンダーの時代 (年号) のリストを取得します。When overridden in a derived class, gets the list of eras in the current calendar.

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

プロパティ値

Int32[]

現在の暦における時代 (年号) を表す整数の配列。An array of integers that represents the eras in the current calendar.

次の例では、Heisei 時代JapaneseCalendar.Eras (1989-2019) が現在の時代 (年号) であった場合に、に格納されている値を表示します。The following example displays the values contained in JapaneseCalendar.Eras when the Heisei era (1989-2019) was the current era.

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

注釈

時代 (年号) は、現在の時代 (年号) が配列の最初の要素となり、最も古い時代 (年号) が配列の最後の要素として使用されます。The eras are in reverse chronological order, with the current era as the first element of the array, and the oldest era as the last element of the array. たとえば、のJapaneseCalendar現在の時代 (年号) の値は、配列の最初の要素である4です。For example, the value of the current era in JapaneseCalendar is 4, which is the first element of the array. とクラスは、 JapaneseCalendar複数の時代 (年号) をサポートしています。 JapaneseLunisolarCalendarOnly the JapaneseCalendar and the JapaneseLunisolarCalendar classes support multiple eras.

重要

和暦の時代 (年号) は天皇の代に基づいているため、変更されることが予想されます。Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. たとえば、JapaneseCalendarJapaneseLunisolarCalendar において、2019 年 5 月 1 日から令和時代が始まることになりました。For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. このような時代 (年号) の変更は、これらのカレンダーを使用するすべてのアプリケーションに影響します。Such a change of era affects all applications that use these calendars. 詳細については「.NET での日本語のカレンダーの新しい時代」をご覧いただき、アプリケーションが影響を受けるかどうかを判断します。See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. 日本語の時代の変更のためのアプリケーションの準備」をご覧いただき、時代の変更に対する状況を確認するために Windows システムでアプリケーションをテストします。See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. 複数の時代 (年号) を含むカレンダーをサポートしている .NET の機能や、複数の時代 (年号) をサポートしているカレンダーを操作する際のベスト プラクティスについては、「Working with eras (時代 (年号) の操作)」をご覧ください。See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

クラスJapaneseCalendarJapaneseLunisolarCalendarクラスは、複数の時代 (年号) をサポートします。The JapaneseCalendar and JapaneseLunisolarCalendar classes support multiple eras. 一方、ほとんどのカレンダー実装では、1つの時代 (年号) がサポートされています。Most calendar implementations, on the other hand, support a single era.

適用対象

こちらもご覧ください