DateTimeFormatInfo.GetEraName(Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> stringPublic Function GetEraName (era As Integer) As StringParámetros
- era
- Int32
Valor entero que representa la era.
Devoluciones
Cadena que contiene el nombre de la era.
Excepciones
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 ha aprovechado desde un punto fijo o evento. Por ejemplo, "A.D". o "C.E." es la era actual del calendario gregoriano.
Los valores era válidos de se enumeran en la Eras propiedad de la clase adecuada derivada de Calendar . Por ejemplo: JapaneseCalendar.Eras muestra una lista de eras compatibles con 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, vea 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 de era japonesa. Para ver 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 pero no es TaiwanCalendar CurrentCulture "zh-TW", NativeCalendarName , GetEraName(Int32) y GetAbbreviatedEraName(Int32) devuelven una cadena vacía ("").