DateTimeFormatInfo.GetEraName(Int32) DateTimeFormatInfo.GetEraName(Int32) DateTimeFormatInfo.GetEraName(Int32) DateTimeFormatInfo.GetEraName(Int32) Method

Definición

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

Valor entero que representa la era.The integer representing the era.

Devoluciones

Cadena que contiene el nombre de la era.A string containing the name of the era.

Excepciones

era no representa una era válida en el calendario especificado en la propiedad Calendar.era does not represent a valid era in the calendar specified in the Calendar property.

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 contado desde un punto o evento fijo.The era name is the name a calendar uses to refer to a period of time reckoned from a fixed point or event. Por ejemplo, "D.C."For example, "A.D." o "era cristiana"or "C.E." es la era actual del calendario gregoriano.is the current era in the Gregorian calendar.

Los valores válidos era para se enumeran Eras en la propiedad de la clase adecuada Calendarderivada de.The valid values for era are listed in the Eras property of the appropriate class derived from Calendar. Por ejemplo: JapaneseCalendar.Eras muestra una lista de las eras admitidas por esta implementación.For example: JapaneseCalendar.Eras displays a list of eras that are supported by this implementation.

Importante

Las eras en los calendarios japoneses se basan en el reino del emperador y, por tanto, se espera que cambien.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Por ejemplo, el 1 de mayo de 2019 marcaba el comienzo de la era Reiwa en JapaneseCalendar y JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Este cambio de era afecta a todas las aplicaciones que usan estos calendarios.Such a change of era affects all applications that use these calendars. Para obtener más información y determinar si sus aplicaciones están entre las afectadas, consulte Handling a new era in the Japanese calendar in .NET (Gestión de una nueva era del calendario japonés en .NET).See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Para obtener más información sobre cómo probar aplicaciones en sistemas Windows para garantizar que estén preparadas para el cambio de era, consulte Prepare your application for the Japanese era change (Preparación de la aplicación para el cambio de era japonesa).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. Consulte Trabajar con eras para ver las características de .NET que admiten calendarios con varias eras y procedimientos recomendados al trabajar con calendarios que admiten varias 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 a los autores de las llamadas

Si el calendario está representado por TaiwanCalendar CurrentCulture pero no es "zh-TW", entonces NativeCalendarName, GetEraName(Int32)y GetAbbreviatedEraName(Int32) devuelven una cadena vacía ("").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 ("").

Se aplica a

Consulte también: