DateTimeFormatInfo.GetEraName(Int32) Método

Definición

Espacio de nombres:

System.Globalization

Ensamblado:

System.Runtime.dll

Source:

DateTimeFormatInfo.cs

Devuelve la cadena que contiene el nombre de la 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

Valor entero que representa la era.

Devoluciones

String

Cadena que contiene el nombre de la era.

Excepciones

ArgumentOutOfRangeException

era no representa una era válida en el calendario especificado en la propiedad Calendar.

Comentarios

El nombre de la era es el nombre que usa un calendario para hacer referencia a un período de tiempo que se calcula desde un punto fijo o evento. Por ejemplo, "A.D." o "C.E." es la era actual en el calendario gregoriano.

Los valores válidos para era se enumeran en la Eras propiedad de la clase adecuada derivada de Calendar. Por ejemplo: JapaneseCalendar.Eras muestra una lista de borrados admitidos por esta implementación.

Importante

Las eras en los calendarios japoneses se basan en el reino del emperador y, por tanto, se espera que cambien. Por ejemplo, el 1 de mayo de 2019 marcaba el comienzo de la era Reiwa en JapaneseCalendar y JapaneseLunisolarCalendar. Este cambio de era afecta a todas las aplicaciones que usan estos calendarios. Para obtener más información y determinar si las aplicaciones se ven afectadas, consulte Control de una nueva era en el calendario japonés en .NET. Para obtener información sobre cómo probar las aplicaciones en sistemas Windows para garantizar su preparación para el cambio de era, consulte Preparación de la aplicación para el cambio en la era japonesa. Para conocer las características de .NET que admiten calendarios con varias eras y procedimientos recomendados al trabajar con calendarios que admiten varias eras, consulte Trabajar con eras.

Notas a los autores de las llamadas

Si el calendario está representado por TaiwanCalendar , pero CurrentCulture no es "zh-TW", NativeCalendarName, GetEraName(Int32)y GetAbbreviatedEraName(Int32) devuelve una cadena vacía ("").

Consulte también

• GetEra(String)