JapaneseCalendar.Eras Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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.
