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 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 ("").