Calendar.Eras 属性

定义

命名空间:

System.Globalization

程序集:

System.Runtime.dll

Source:

Calendar.cs

当在派生类中重写时，获取当前日历中的纪元列表。

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

表示当前日历中的纪元的整数数组。

示例

以下示例显示当 Heisei 时代 (1989-2019) 为当前时代时所包含的 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
'

注解

纪元按倒序按时间顺序排列，当前纪元是数组的第一个元素，而最早的纪元是数组的最后一个元素。 例如，中 JapaneseCalendar 当前纪元的值为 4，这是数组的第一个元素。 JapaneseCalendar只有 和 JapaneseLunisolarCalendar 类支持多个纪元。

重要

日本历法中的年号是根据天皇统治来命名的，因此预计会发生变化。 例如，2019 年 5 月 1 日在 JapaneseCalendar 和 JapaneseLunisolarCalendar 中标志着令和年号的开始。 这种年号的变化会影响使用这些日历的所有应用程序。 有关详细信息并确定应用程序是否受到影响，请参阅 在 .NET 中处理日语日历中的新纪元。 有关在 Windows 系统上测试应用程序以确保其准备好进行纪元更改的信息，请参阅 准备应用程序应对日本纪元更改。 有关 .NET 中支持具有多个纪元的日历的功能以及使用支持多个纪元的日历时的最佳做法，请参阅 使用纪元。

JapaneseCalendar和 JapaneseLunisolarCalendar 类支持多个纪元。 另一方面，大多数日历实现支持单个纪元。

另请参阅

• CurrentEra