JapaneseCalendar.Eras Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient la liste des ères dans 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()Valeur de propriété
Tableau d'entiers qui représente les ères dans JapaneseCalendar.
Exemples
L’exemple suivant affiche les valeurs contenues dans la Eras propriété .
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
'
Remarques
Le calendrier japonais reconnaît une époque pour le règne de chaque empereur. Les deux ères les plus récentes sont l’ère Heisei, à partir de l’année calendaire grégorienne 1989, et l’ère Reiwa, à partir de l’année grégorienne 2019. Le nom de l’ère est généralement affiché avant l’année. Par exemple, l’année civile grégorienne 2001 est l’année civile japonaise Heisei 13. Notez que la première année d’une ère est appelée « Gannen ». Par conséquent, l’année grégorienne 1989 était l’année civile japonaise Heisei Gannen.
Important
Les ères des calendriers japonais sont basées sur le règne de l’empereur et sont donc amenées à changer. Par exemple, le 1 mai 2019 a marqué le début de l’ère Reiwa dans JapaneseCalendar et JapaneseLunisolarCalendar. Ce changement d’ère affecte toutes les applications qui utilisent ces calendriers. Pour plus d’informations et pour déterminer si vos applications sont affectées, consultez Gestion d’une nouvelle ère dans le calendrier japonais dans .NET. Pour plus d’informations sur le test de vos applications sur les systèmes Windows afin de garantir leur préparation au changement d’ère, consultez Préparer votre application pour le changement d’ère japonaise. Pour connaître les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour connaître les meilleures pratiques lors de l’utilisation de calendriers qui prennent en charge plusieurs ères, consultez Utilisation des ères.
Cette classe affecte des nombres aux ères comme suit :
| Valeur GetEra | Nom de l’ère | Abréviation era | Dates grégoriennes |
|---|---|---|---|
| 5 | 令和 (Reiwa) | 令和 (R, r) | Du 1er mai 2019 à aujourd’hui |
| 4 | 平成 (Heisei) | 平 (H, h) | Du 8 janvier 1989 à aujourd’hui |
| 3 | 昭和 (Showa) | 昭 (S, s) | 25 décembre 1926 au 7 janvier 1989 |
| 2 | ス正 (Taisho) | a) (T, t) | Du 30 juillet 1912 au 24 décembre 1926 |
| 1 | 明治 (Meiji) | 明 (M, m) | Du 8 septembre 1868 au 29 juillet 1912 |
Cette classe gère les dates du 8 septembre de l’année Meiji 1 (1er janvier 1868 du calendrier grégorien). Bien que le calendrier japonais ait été passé d’un calendrier lunaire à un calendrier solaire dans l’année Meiji 6 (1873 du calendrier grégorien), cette implémentation est basée uniquement sur le calendrier solaire.
Notes
Si des ères supplémentaires sont ajoutées à l’avenir, les applications peuvent rencontrer plus que les cinq ères attendues pour le calendrier japonais. Vos applications doivent être testées pour s’assurer qu’elles continuent de fonctionner dans un tel événement ; consultez Gestion de l’ère pour le calendrier japonais.
