Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

DateTimeFormatInfo.GetAbbreviatedEraName Method

Returns the string containing the abbreviated name of the specified era, if an abbreviation exists.

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

'Declaration
Public Function GetAbbreviatedEraName ( _
	era As Integer _
) As String

Parameters

era
Type: System.Int32

The integer representing the era.

Return Value

Type: System.String
A string containing the abbreviated name of the specified era, if an abbreviation exists.
-or-
A string containing the full name of the era, if an abbreviation does not exist.

ExceptionCondition
ArgumentOutOfRangeException

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

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.

The valid values for era are listed in the Eras property of the appropriate class derived from Calendar. For example: JapaneseCalendar.Eras displays a list of eras that are supported by this implementation.

In the JapaneseCalendar class, the abbreviated era name is the first character of the full era name. This character is either the single-character case-insensitive Latin alphabet abbreviation or the single-character Kanji abbreviation.

Notes to Callers

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft