DateTimeFormatInfo.GetEraName(Int32) Metodo

Definizione

Restituisce la stringa contenente il nome dell'era specificata.

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

Parametri

era
Int32

Valore intero che rappresenta l'era.

Restituisce

String

Stringa contenente il nome dell'era.

Eccezioni

era non rappresenta un'era valida nel calendario specificato nella proprietà Calendar.

Commenti

Il nome dell'era è il nome utilizzato da un calendario per fare riferimento a un periodo di tempo calcolato da un punto fisso o da un evento. Ad esempio, "A.D." o "C.E". è l'era corrente nel calendario gregoriano.

I valori validi per era sono elencati nella Eras proprietà della classe appropriata derivata da Calendar . Ad esempio: JapaneseCalendar.Eras visualizza un elenco di ere supportate da questa implementazione.

Importante

Le ere nel calendario giapponese sono basate sul regno dell'imperatore e pertanto è previsto che cambino. Ad esempio, il 1° maggio 2019 contraddistingue l'inizio dell'era Reiwa in JapaneseCalendar e JapaneseLunisolarCalendar. Questo cambio di era interessa tutte le applicazioni che usano questi calendari. Per altre informazioni e per determinare se le applicazioni sono interessate, vedere Gestione di una nuova era nel calendario giapponese in .NET. Per informazioni sul test delle applicazioni nei sistemi Windows per garantire la conformità per il cambiamento di era, vedere Preparare l'applicazione per la modifica dell'era giapponese. Per le funzionalità in .NET che supportano calendari con più ere e per le procedure consigliate quando si lavora con calendari che supportano più ere, vedere Uso delle ere.

Note per i chiamanti

Se il calendario è rappresentato da TaiwanCalendar ma CurrentCulture non è "zh-TW", NativeCalendarName , e GetEraName(Int32) GetAbbreviatedEraName(Int32) restituiscono una stringa vuota ("").

Si applica a

Vedi anche