JapaneseCalendar.Eras Propriété

Définition

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é

Int32[]

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.

S’applique à

Voir aussi