JapaneseCalendar.Eras Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá seznam ér v objektu 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()
Hodnota vlastnosti
Pole celých čísel, které představuje éry v objektu JapaneseCalendar.
Příklady
Následující příklad zobrazí hodnoty obsažené ve Eras vlastnosti .
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
'
Poznámky
Japonský kalendář rozpoznává jednu éru pro každou vládu císaře. Dvě nejnovější éry jsou éra Heisei, která začíná v gregoriánském kalendářním roce 1989, a éra Reiwa, počínaje gregoriánským kalendářním rokem 2019. Název éry se obvykle zobrazuje před rokem. Například gregoriánský kalendářní rok 2001 je japonský kalendářní rok Heisei 13. Všimněte si, že první rok éry se nazývá Gannen. Proto byl gregoriánský kalendářní rok 1989 japonským kalendářním rokem Heisei Gannen.
Důležité
Éry v japonských kalendářích jsou založeny na vládě císaře, a proto se očekává, že se změní. Například 1. května 2019 bylo začátkem éry Reiwa v JapaneseCalendar a JapaneseLunisolarCalendar. Taková změna éry ovlivní všechny aplikace, které tyto kalendáře používají. Další informace a informace o tom, jestli se to týká vašich aplikací, najdete v tématu Zpracování nové éry v japonském kalendáři v .NET. Informace o testování aplikací v systémech Windows, abyste zajistili jejich připravenost na změnu éry, najdete v tématu Příprava aplikace na změnu japonské éry. Funkce v .NET, které podporují kalendáře s více érami, a osvědčené postupy při práci s kalendáři, které podporují více ér, najdete v tématu Práce s érami.
Tato třída přiřadí čísla k érám následujícím způsobem:
Hodnota GetEra | Název éry | Zkratka éry | Gregoriánská data |
---|---|---|---|
5 | 令和 (Reiwa) | 令和 (R, r) | Od 1. května 2019 do současnosti |
4 | 平成 (Heisei) | 平 (H, h) | 8. ledna 1989 až do současnosti |
3 | 昭和 (Showa) | 昭 (S, s) | 25. prosince 1926 až 7. ledna 1989 |
2 | 大正 (Taisho) | 大 (T, t) | 30. července 1912 - 24. prosince 1926 |
1 | 明治 (Meiji) | 明 (M, m) | 8. září 1868 - 29. července 1912 |
Tato třída zpracovává data od 8. září v roce Meiji 1 (1. ledna 1868 v gregoriánském kalendáři). Ačkoli japonský kalendář byl převeden z lunárního kalendáře na solární kalendář v roce Meiji 6 (1873 gregoriánského kalendáře), tato implementace je založena pouze na solárním kalendáři.
Poznámka
Pokud v budoucnu přidají další éry, aplikace můžou v japonském kalendáři narazit na více než očekávaných pět ér. Vaše aplikace by měly být testovány, aby se zajistilo, že v takovém případě budou i nadále fungovat. Viz Zpracování éry pro japonský kalendář.