JapaneseCalendar.Eras Свойство

Определение

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

System.Globalization

Сборки:

mscorlib.dll, System.Globalization.Calendars.dll

Сборка:

System.Runtime.dll

Сборка:

System.Globalization.Calendars.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Возвращает список эр в классе 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
'

Комментарии

Японский календарь признает одну эпоху для правления каждого императора. Две последние эпохи — эра Heisei, начиная с григорианского календарного года 1989 года, и эры Рейва, начиная с григорианского календарного года 2019 года. Название эпохи обычно отображается до года. Например, григорианский календарный год 2001 года является японским календарным годом Heisei 13. Обратите внимание, что первый год эпохи называется "Ганнен". Таким образом, григорианский календарный год 1989 года был японским календарным годом Heisei Ганнен.

Важно!

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

Этот класс присваивает числа эрам следующим образом:

Значение GetEra	Имя эры	Аббревиатура эры	Григорианские даты
5	令和 (Reiwa)	令和 (R, r)	1 мая 2019 г.
4	平成 (Heisei)	平 (H, h)	8 января 1989 г.
3	昭和 (Showa)	昭 (S, s)	25 декабря 1926 по 7 января 1989 г.
2	大正 (Тайшо)	大 (T, t)	30 июля 1912 г. по 24 декабря 1926 г.
1	明治 (Meiji)	明 (M, m)	8 сентября 1868 г. по 29 июля 1912 г.

Этот класс обрабатывает даты с 8 сентября в году Meiji 1 (1 января 1868 года григорианского календаря). Хотя японский календарь был переключен с лунного календаря на солнечный календарь в году Meiji 6 (1873 григорианского календаря), эта реализация основана только на солнечном календаре.

Примечание

Если в будущем будут добавлены дополнительные эры, приложения могут столкнуться с более чем ожидаемыми пятью эрами для японского календаря. Приложения должны быть протестированы, чтобы убедиться, что они продолжают работать в таком событии; См. раздел "Обработка эры" для японского календаря.

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

• CurrentEra