JapaneseCalendar.Eras Właściwość

Definicja

Przestrzeń nazw:

System.Globalization

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

JapaneseCalendar.cs

Pobiera listę wymazów 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 epoki w obiekcie JapaneseCalendar.

Przykłady

W poniższym przykładzie Eras przedstawiono wartości zawarte we właściwości .

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 rozpoznaje jedną epokę panowania każdego cesarza. Dwie ostatnie epoki to era Heisei, począwszy od gregoriańskiego roku kalendarzowego 1989, a era 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 ery nosi nazwę "Gannen". Dlatego rok kalendarzowy gregoriański 1989 był japońskim rokiem kalendarzowym Heisei Gannen.

Ważna

Era w japońskich kalendarzach opiera 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 i JapaneseLunisolarCalendar. Taka zmiana ery wpływa na wszystkie aplikacje korzystające z tych kalendarzy. Aby uzyskać więcej informacji i określić, czy twoje aplikacje mają wpływ, 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 ery, zobacz Przygotowanie aplikacji do zmiany w erze japońskiej. Aby uzyskać informacje o funkcjach na platformie .NET, które obsługują kalendarze z wieloma epokami i aby uzyskać najlepsze rozwiązania dotyczące pracy z kalendarzami obsługującymi wiele epok, zobacz Praca z erami.

Ta klasa przypisuje liczby do epok 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)	23 października 1868 do 29 lipca 1912 r.

Ta klasa obsługuje daty od 23 października 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 z kalendarza gregoriańskiego), ta implementacja opiera się tylko na kalendarzu słonecznym.

Note

Jeśli w przyszłości zostaną dodane dodatkowe wymazy, aplikacje mogą napotkać więcej niż oczekiwano pięć ery dla kalendarza japońskiego. Przetestuj aplikacje, aby upewnić się, że będą nadal działać w takim przypadku. Aby uzyskać więcej informacji, zobacz Obsługa ery dla kalendarza japońskiego.

Zobacz też

• CurrentEra