DateTimeFormatInfo.GetEraName(Int32) Metodo

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

Origine:

DateTimeFormatInfo.cs

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

ArgumentOutOfRangeException

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

Commenti

Il nome dell'era è il nome usato 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 era 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 sui test delle applicazioni nei sistemi Windows per garantire la loro idoneità per la modifica dell'era, vedere Preparare l'applicazione per la modifica dell'era giapponese. Per le funzionalità di .NET che supportano calendari con più era e per le procedure consigliate quando si usano calendari che supportano più epoche, vedere Uso delle era.

Note per i chiamanti

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

Vedi anche

• GetEra(String)