Calendar.Eras Propriété

Définition

En cas de substitution dans une classe dérivée, obtient la liste des ères du calendrier en cours.When overridden in a derived class, gets the list of eras in the current calendar.

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.An array of integers that represents the eras in the current calendar.

Exemples

L’exemple suivant affiche les valeurs contenues dans JapaneseCalendar.Eras lorsque l’ère Heisei (1989-2019) était l’ère actuelle.The following example displays the values contained in JapaneseCalendar.Eras when the Heisei era (1989-2019) was the current era.

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 l’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.The eras are in reverse chronological order, with the current era as the first element of the array, and the oldest era as the last element of the array. Par exemple, la valeur de l’ère actuelle dans JapaneseCalendar est 4, qui est le premier élément du tableau.For example, the value of the current era in JapaneseCalendar is 4, which is the first element of the array. Seules les classes JapaneseCalendar et JapaneseLunisolarCalendar prennent en charge plusieurs ères.Only the JapaneseCalendar and the JapaneseLunisolarCalendar classes support multiple eras.

Important

Les ères des calendriers japonais sont basées sur le règne de l’empereur et sont donc amenées à changer.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Par exemple, le 1 mai 2019 a marqué le début de l’ère Reiwa dans JapaneseCalendar et JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Ce changement d’ère affecte toutes les applications qui utilisent ces calendriers.Such a change of era affects all applications that use these calendars. Pour plus d’informations et pour déterminer si vos applications sont affectées, consultez Handling a new era in the Japanese calendar in .NET.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Pour plus d’informations sur le test de vos applications sur les systèmes Windows pour garantir leur préparation au changement d’ère, consultez Préparer votre application au changement de l’ère japonaise.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Consultez Utilisation des ères pour connaître les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et les bonnes pratiques d’utilisation de ce type de calendrier.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Les classes JapaneseCalendar et JapaneseLunisolarCalendar prennent en charge plusieurs ères.The JapaneseCalendar and JapaneseLunisolarCalendar classes support multiple eras. La plupart des implémentations de calendrier, en revanche, prennent en charge une seule ère.Most calendar implementations, on the other hand, support a single era.

S’applique à

Voir aussi