Calendar.Eras Свойство

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Исходный код:

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

Массив целых чисел для представления эр в текущем календаре.

Примеры

В следующем примере отображаются значения, содержащиеся в JapaneseCalendar.Eras том, когда эра Хэйсэй (1989–2019) была текущей эрой.

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, что является первым элементом массива. Только классы JapaneseCalendarJapaneseLunisolarCalendar и поддерживают несколько эпох.

Важно!

Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва. Изменение эры затрагивает все приложения, использующие эти календари. Дополнительные сведения и определение того, затронуты ли приложения, см. в статье Обработка новой эры в японском календаре в .NET. Сведения о тестировании приложений в системах Windows для обеспечения их готовности к изменению эры см. в статье Подготовка приложения к изменению японской эры. Сведения о функциях в .NET, поддерживающих календари с несколькими эрами, а также рекомендации по работе с календарями, поддерживающими несколько эпох, см. в статье Работа с эрами.

Классы JapaneseCalendar и JapaneseLunisolarCalendar поддерживают несколько эпох. С другой стороны, большинство реализаций календаря поддерживают одну эпоху.

См. также раздел

• CurrentEra