DateTimeFormatInfo.GetEraName(Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> stringPublic Function GetEraName (era As Integer) As StringParâmetros
- era
- Int32
O inteiro que representa a era.
Retornos
Uma cadeia de caracteres que contém o nome da era.
Exceções
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 ("").
