DateTimeFormatInfo.GetAbbreviatedEraName(Int32) Méthode

Définition

Espace de noms:

System.Globalization

Assembly:

System.Runtime.dll

Source:

DateTimeFormatInfo.cs

Retourne une chaîne contenant le nom abrégé de l'ère spécifiée, si une abréviation existe.

public:
 System::String ^ GetAbbreviatedEraName(int era);

public string GetAbbreviatedEraName (int era);

member this.GetAbbreviatedEraName : int -> string

Public Function GetAbbreviatedEraName (era As Integer) As String

Paramètres

era

Int32

Entier représentant l’ère.

Retours

String

Chaîne contenant le nom abrégé de l'ère spécifiée, si une abréviation existe.

- ou -

Chaîne contenant le nom complet de l'ère spécifiée, s'il n'existe pas d'abréviation.

Exceptions

ArgumentOutOfRangeException

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’époque 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 une liste d’ères prises en charge par cette implémentation.

Dans la JapaneseCalendar classe, le nom d’ère abrégé est le premier caractère du nom complet de l’ère. Ce caractère est soit l’abréviation de l’alphabet latin à caractère unique qui ne respecte pas la casse ou l’abréviation Kanji à caractère unique.

Notes pour les appelants

Si Calendar est le TaiwanCalendar mais CurrentCulture n’est pas « zh-TW », , NativeCalendarNameGetEraName(Int32)et GetAbbreviatedEraName(Int32) retourne une chaîne vide («  »).

Voir aussi

• JapaneseCalendar
• TaiwanCalendar