DateTimeFormatInfo.GetEraName(Int32) Méthode
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.
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 -> stringPublic Function GetEraName (era As Integer) As StringParamè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 (« »).
