DateTimeFormatInfo.GetEraName(Int32) Método

Definição

Namespace:

System.Globalization

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

DateTimeFormatInfo.cs

Retorna a cadeia de caracteres que contém o nome da era especificada.

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

public string GetEraName(int era);

member this.GetEraName : int -> string

Public Function GetEraName (era As Integer) As String

Parâmetros

era

Int32

O inteiro que representa a era.

Retornos

String

Uma cadeia de caracteres que contém o nome da era.

Exceções

ArgumentOutOfRangeException

era não representa uma era válida no calendário especificado na Calendar propriedade.

Comentários

O nome da era é o nome que um calendário usa para se referir a um período de tempo contado de um ponto ou evento fixo. Por exemplo, "A.D." ou "C.E." é a era atual no calendário gregoriano.

Os valores válidos são era listados na Eras propriedade da classe apropriada derivada de Calendar. Por exemplo: JapaneseCalendar.Eras exibe uma lista de eras compatíveis com essa implementação.

Importante

Eras nos calendários japoneses são baseadas no reinado do imperador e, portanto, espera-se que mudem. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e JapaneseLunisolarCalendar. Essa mudança de era afeta todos os aplicativos que usam esses calendários. Para obter mais informações e determinar se seus aplicativos são afetados, consulte Como lidar com uma nova era no calendário japonês no .NET. Para obter informações sobre como testar seus aplicativos em sistemas Windows para garantir sua preparação para a alteração da era, consulte Preparar seu aplicativo para a alteração da era japonesa. Para obter recursos no .NET que dão suporte a calendários com várias eras e práticas recomendadas ao trabalhar com calendários que dão suporte a várias eras, consulte Trabalhando com eras.

Notas aos Chamadores

Se o calendário for representado por TaiwanCalendar , mas não CurrentCulture for "zh-TW", então NativeCalendarName, GetEraName(Int32)e GetAbbreviatedEraName(Int32) retornar uma cadeia de caracteres vazia ("").

Confira também

• GetEra(String)