Calendar.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.
En cas de substitution dans une classe dérivée, obtient la liste des ères dans le calendrier actuel.
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é
Tableau d’entiers qui représente les ères dans le calendrier actuel.
Exemples
L’exemple suivant affiche les valeurs contenues dans JapaneseCalendar.Eras l’ère Heisei (1989-2019) était l’ère actuelle.
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. Par exemple, la valeur de l’ère actuelle est JapaneseCalendar 4, qui est le premier élément du tableau. Seules les JapaneseCalendarJapaneseLunisolarCalendar classes prennent en charge plusieurs ères.
Important
Les ères dans les calendriers japonais sont basées sur le règne de l’empereur et sont donc censées changer. Par exemple, le 1er mai 2019 a marqué le début de l’ère Reiwa dans le 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 les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et pour les meilleures pratiques lors de l’utilisation de calendriers qui prennent en charge plusieurs ères, consultez Utilisation des ères.
Les classes et JapaneseLunisolarCalendar les JapaneseCalendar classes prennent en charge plusieurs ères. La plupart des implémentations de calendrier, d’autre part, prennent en charge une ère unique.