DateTimeFormatInfo.GetEraName(Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve a cadeia que contém o nome da era especificada.
public:
System::String ^ GetEraName(int era);public string GetEraName(int era);member this.GetEraName : int -> stringPublic Function GetEraName (era As Integer) As StringParâmetros
- era
- Int32
O inteiro representa a era.
Devoluções
Um fio contendo o nome da época.
Exceções
era não representa uma era válida no calendário especificado na Calendar propriedade.
Observações
O nome da era é o nome que um calendário usa para se referir a um período de tempo calculado a partir de um ponto fixo ou evento. Por exemplo, "D.C." ou "C.E." é a era atual no calendário gregoriano.
Os valores válidos para era estão listados na Eras propriedade da classe apropriada derivada de Calendar. Por exemplo: JapaneseCalendar.Eras apresenta uma lista de eras suportadas por esta implementação.
Importante
As 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 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 prontidão para a mudança de era, consulte Preparar seu aplicativo para a mudança de era japonesa. Para obter recursos no .NET que oferecem suporte a calendários com várias eras e práticas recomendadas ao trabalhar com calendários que suportam várias eras, consulte Trabalhando com eras.
Notas para Chamadores
Se o calendário for representado por TaiwanCalendar mas o CurrentCulture não for "zh-TW", então NativeCalendarName, GetEraName(Int32), e GetAbbreviatedEraName(Int32) devolver uma cadeia vazia ("").