DateTimeFormatInfo.GetEraName(Int32) Método

Definição

Retorna a cadeia de caracteres que contém o nome da era especificado.Returns the string containing the name of the specified era.

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.The integer representing the era.

Retornos

String

Uma cadeia de caracteres que contém o nome da era.A string containing the name of the era.

Exceções

era não representa uma era válida no calendário especificado na propriedade Calendar.era does not represent a valid era in the calendar specified in the Calendar property.

Comentários

O nome da era é o nome que um calendário usa para se referir a um período de tempo respeitada de um ponto fixo ou evento.The era name is the name a calendar uses to refer to a period of time reckoned from a fixed point or event. Por exemplo, "D.C."For example, "A.D." ou "C.E."or "C.E." é a era atual no calendário gregoriano.is the current era in the Gregorian calendar.

Os valores válidos para era estão listados na Eras propriedade da classe apropriada derivada de Calendar .The valid values for era are listed in the Eras property of the appropriate class derived from Calendar. Por exemplo: JapaneseCalendar.Eras exibe uma lista de apagar que têm suporte nesta implementação.For example: JapaneseCalendar.Eras displays a list of eras that are supported by this implementation.

Importante

As eras nos calendários japoneses se baseiam no reinado do Imperador e, portanto, estão sujeitas a alterações.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e no JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Tal alteração de eras afeta todos os aplicativos que usam esses calendários.Such a change of era affects all applications that use these calendars. Veja Tratamento de uma nova era no calendário japonês no .NET para obter mais informações e para determinar se seus aplicativos são afetados.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Veja Preparar seu aplicativo para a mudança de era no calendário japonês para obter informações sobre como testar seus aplicativos em sistemas Windows para assegurar que eles estejam preparados para a alteração de era.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Confira Trabalhando com eras para ver recursos do .NET que dão suporte a calendários com várias eras e confira práticas recomendadas de trabalho com calendários que dão suporte a várias eras.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Notas aos 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) retornará uma cadeia de caracteres vazia ("").If the calendar is represented by TaiwanCalendar but the CurrentCulture is not "zh-TW", then NativeCalendarName, GetEraName(Int32), and GetAbbreviatedEraName(Int32) return an empty string ("").

Aplica-se a

Confira também