JapaneseCalendar.Eras Właściwość

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Źródło:

JapaneseCalendar.cs

Pobiera listę ery w pliku 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()

Wartość właściwości

Int32[]

Tablica liczb całkowitych, która reprezentuje ery w obiekcie JapaneseCalendar.

Przykłady

W poniższym przykładzie są wyświetlane wartości zawarte we Eras właściwości .

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
'

Uwagi

Japoński kalendarz uznaje jedną erę za panowanie każdego cesarza. Dwie ostatnie epoki to era Heisei, począwszy od gregoriańskiego roku kalendarzowego 1989 i ery Reiwa, począwszy od gregoriańskiego roku kalendarzowego 2019. Nazwa ery jest zwykle wyświetlana przed rokiem. Na przykład rok kalendarzowy gregoriański 2001 to japoński rok kalendarzowy Heisei 13. Należy pamiętać, że pierwszy rok epoki nosi nazwę "Gannen". Dlatego rok kalendarzowy gregoriański 1989 był japońskim rokiem kalendarzowym Heisei Gannen.

Ważne

Ery w japońskich kalendarzach opierają się na panowaniu cesarza i dlatego oczekuje się, że się zmienią. Na przykład 1 maja 2019 r. oznaczało początek ery Reiwa w JapaneseCalendar erze i JapaneseLunisolarCalendar. Taka zmiana ery wpływa na wszystkie aplikacje korzystające z tych kalendarzy. Aby uzyskać więcej informacji i określić, czy dotyczy to aplikacji, zobacz Obsługa nowej ery w kalendarzu japońskim na platformie .NET. Aby uzyskać informacje na temat testowania aplikacji w systemach Windows w celu zapewnienia gotowości do zmiany epoki, zobacz Przygotowanie aplikacji do zmiany ery japońskiej. Aby uzyskać informacje o funkcjach platformy .NET, które obsługują kalendarze z wieloma epokami i najlepsze rozwiązania dotyczące pracy z kalendarzami obsługującymi wiele epok, zobacz Praca z erami.

Ta klasa przypisuje liczby do ery w następujący sposób:

Wartość GetEra	Nazwa ery	Skrót ery	Daty gregoriańskiego
5	令和 (Reiwa)	令和 (R, r)	1 maja 2019 r.
4	平成 (Heisei)	平 (H, h)	8 stycznia 1989 r.
3	昭和 (Showa)	昭 (S, s)	25 grudnia 1926 do 7 stycznia 1989 r.
2	正 (Taisho)	... (T, t)	30 lipca 1912 do 24 grudnia 1926 r.
1	明治 (Meiji)	明 (M, m)	8 września 1868 do 29 lipca 1912 r.

Ta klasa obsługuje daty od 8 września w roku Meiji 1 (1 stycznia 1868 roku kalendarza gregoriańskiego). Chociaż japoński kalendarz został przełączony z kalendarza księżycowego na kalendarz słoneczny w roku Meiji 6 (1873 kalendarza gregoriańskiego), ta implementacja jest oparta tylko na kalendarzu słonecznym.

Uwaga

Jeśli w przyszłości zostaną dodane dodatkowe era, aplikacje mogą napotkać więcej niż oczekiwano pięć epok dla kalendarza japońskiego. Aplikacje powinny być testowane w celu zapewnienia, że będą nadal działać w takim przypadku; Zobacz Obsługa ery dla kalendarza japońskiego.

Zobacz też

• CurrentEra