DateTimeFormatInfo.GetEraName(Int32) Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

DateTimeFormatInfo.cs

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

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 propriedade Calendar.

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 para era são 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

As eras nos calendários japoneses se baseiam no reinado do Imperador e, portanto, estão sujeitas a alterações. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e no JapaneseLunisolarCalendar. Tal alteração de eras afeta todos os aplicativos que usam esses calendários. Para obter mais informações e determinar se seus aplicativos são afetados, consulte Manipulando 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 recursos no .NET que dão suporte a calendários com várias eras e para 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)