Partager via


DateTimeFormatInfo.GetEraName Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Returns the string containing the name of the specified era.

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function GetEraName ( _
    era As Integer _
) As String
public string GetEraName(
    int era
)

Parameters

Return Value

Type: System.String
A string containing the name of the era.

Exceptions

Exception Condition
ArgumentOutOfRangeException

era does not represent a valid era in the calendar specified in the Calendar property.

Remarks

The era name is the name a calendar uses to refer to a period of time reckoned from a fixed point or event. For example, "A.D." or "C.E." is the current era in the Gregorian calendar.

An array that contains the valid values for era is returned by the Eras property of the appropriate class derived from Calendar. For example, the JapaneseCalendar.Eras property returns a list of eras that are supported by this implementation.

Notes to Callers

If DateTimeFormatInfo.Calendar is the TaiwanCalendar but the Thread.CurrentCulture is not "zh-TW", then GetEraName and GetAbbreviatedEraName return an empty string ("").

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.