Calendar.Eras Propriété

Définition

Espace de noms:

System.Globalization

Assembly:

System.Runtime.dll

Source:

Calendar.cs

En cas de substitution dans une classe dérivée, obtient la liste des ères du calendrier en cours.

public:
 abstract property cli::array <int> ^ Eras { cli::array <int> ^ get(); };

public abstract int[] Eras { get; }

member this.Eras : int[]

Public MustOverride ReadOnly Property Eras As Integer()

Valeur de propriété

Int32[]

Tableau d'entiers qui représente les ères du calendrier en cours.

Exemples

L’exemple suivant affiche les valeurs contenues dans JapaneseCalendar.Eras lorsque l’ère Heisei (1989-2019) était l’ère actuelle.

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

Les ères sont dans un ordre chronologique inverse, avec l’ère actuelle comme premier élément du tableau et l’ère la plus ancienne comme dernier élément du tableau. Par exemple, la valeur de l’ère actuelle dans JapaneseCalendar est 4, qui est le premier élément du tableau. Seules les JapaneseCalendar classes et prennent JapaneseLunisolarCalendar en charge plusieurs ères.

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.

Les JapaneseCalendar classes et JapaneseLunisolarCalendar prennent en charge plusieurs ères. En revanche, la plupart des implémentations de calendrier prennent en charge une seule ère.

Voir aussi

• CurrentEra