DateTimeFormatInfo.GetEraName(Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
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 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 ("").