Partager via


DateTimeFormatInfo.GetEraName(Int32) Méthode

Définition

Retourne la chaîne contenant le nom de l'ère spécifiée.

public:
 System::String ^ GetEraName(int era);
public string GetEraName (int era);
member this.GetEraName : int -> string
Public Function GetEraName (era As Integer) As String

Paramètres

era
Int32

Entier représentant l’ère.

Retours

Chaîne contenant le nom de l'ère.

Exceptions

era ne représente pas une ère valide dans le calendrier spécifié dans la propriété Calendar.

Remarques

Le nom de l’ère est le nom utilisé par un calendrier pour faire référence à une période de temps comptée à partir d’un point fixe ou d’un événement. Par exemple, « A.D. » ou « C.E. » est l’ère actuelle du calendrier grégorien.

Les valeurs valides pour era sont répertoriées dans la Eras propriété de la classe appropriée dérivée de Calendar. Par exemple : JapaneseCalendar.Eras affiche la liste des ères prises en charge par cette implémentation.

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 des 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 d’ères.

Notes pour les appelants

Si le calendrier est représenté par TaiwanCalendar mais que n’est CurrentCulture pas « zh-TW », , NativeCalendarNameGetEraName(Int32)et GetAbbreviatedEraName(Int32) retournent une chaîne vide («  »).

S’applique à

Voir aussi