DateTimeFormatInfo.GetEraName(Int32) Méthode

Définition

Retourne la chaîne contenant le nom de l'ère spécifiée.Returns the string containing the name of the specified era.

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.The integer representing the era.

Retours

Chaîne contenant le nom de l'ère.A string containing the name of the era.

Exceptions

era ne représente pas une ère valide dans le calendrier spécifié dans la propriété Calendar.era does not represent a valid era in the calendar specified in the Calendar property.

Remarques

Le nom de l’ère est le nom qu’un calendrier utilise pour faire référence à une période calculée à partir d’un point fixe ou d’un événement.The era name is the name a calendar uses to refer to a period of time reckoned from a fixed point or event. Par exemple, « A.D. »For example, "A.D." ou « notre ère »or "C.E." est l’ère actuelle dans le calendrier grégorien.is the current era in the Gregorian calendar.

Les valeurs valides pour era sont répertoriées dans la propriété Eras de la classe appropriée dérivée de Calendar.The valid values for era are listed in the Eras property of the appropriate class derived from Calendar. Par exemple : JapaneseCalendar.Eras affiche une liste des ères qui sont prises en charge par cette implémentation.For example: JapaneseCalendar.Eras displays a list of eras that are supported by this implementation.

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.

Notes pour les appelants

Si le calendrier est représenté par TaiwanCalendar mais que le CurrentCulture n’est pas « zh-TW », NativeCalendarName, GetEraName(Int32)et GetAbbreviatedEraName(Int32) retournent une chaîne vide ("").If the calendar is represented by TaiwanCalendar but the CurrentCulture is not "zh-TW", then NativeCalendarName, GetEraName(Int32), and GetAbbreviatedEraName(Int32) return an empty string ("").

S’applique à

Voir aussi