DateTimeFormatInfo.GetEra Method

Returns the integer representing the specified era name.

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

'Declaration
Public Function GetEra ( _
	eraName As String _
) As Integer

Parameters

eraName
Type: System.String
The string containing the name of the era.

Return Value

Type: System.Int32
The integer representing the era, if eraName is valid; otherwise, -1.

ExceptionCondition
ArgumentNullException

eraName is Nothing.

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 comparison with eraName is case-insensitive, for example, "A.D." is equivalent to "a.d.".

GetEra ignores punctuation in abbreviated era names, only if the GregorianCalendar is selected in DateTimeFormatInfo.Calendar and the culture uses "A.D." as the era name, that is, "A.D." is equivalent to "AD".

GetEra compares eraName with the full era name returned by GetEraName and with the abbreviated era name returned by GetAbbreviatedEraName.

Platform Notes

Silverlight for Windows Phone Silverlight for Windows Phone

 This member returns -1 for the fr-FR culture.

The following example shows that DateTimeFormatInfo ignores the punctuation in the era name, only if the calendar is Gregorian and the culture uses the era name "A.D.".


Imports System.Globalization
Imports System.Windows.Media

Public Class Example

   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      ' Create an array containing selected culture names.
      Dim cultureNames() As String = { "ar-DZ", "ar-EG", "ar-IQ", "ar-JO", "ar-LB", _ 
                                       "ar-LY", "ar-MA", "ar-SA", "ar-SY", "ar-TN", _
                                       "be-BY", "bg-BG", "cs-CZ", "da-DK", "de-AT", _ 
                                       "de-CH", "de-DE", "dv-MV", "el-GR", "en-AU", _
                                       "en-CA", "en-GB", "en-NZ", "en-US", "es-AR", _
                                       "es-BO", "es-CL", "es-CO", "es-EC", "es-ES", _
                                       "es-GT", "es-HN", "es-MX", "es-NI", "es-PE", _
                                       "es-PY", "es-VE", "fa-IR", "fi-FI", "fr-BE", _
                                       "fr-FR", "he-IL", "hi-IN", "hr-HR", "hu-HU", _
                                       "id-ID", "is-IS", "it-IT", "ja-JP", "ka-GE", _
                                       "ko-KR", "ms-MY", "nl-NL", "nn-NO", "pl-PL", _ 
                                       "pt-BR", "pt-PT", "ro-RO", "ru-RU", "sa-IN", _
                                       "sk-SK", "sl-SI", "sq-AL", "sv-SE", "sw-KE", _ 
                                       "syr-SY", "ta-IN", "th-TH", "tr-TR", "uk-UA", _ 
                                       "ur-PK", "vi-VN", "zh-CN", "zh-HK", "zh-SG", _ 
                                       "zh-TW"}

      ' Create strings with punctuation and without.
      Dim strADPunc As String = "A.D."
      Dim strADNoPunc As String = "AD"
      Dim strCEPunc As String = "C.E."
      Dim strCENoPunc As String = "CE"

      outputBlock.FontFamily = New FontFamily("Courier New")

      ' Call DTFI.GetEra for each culture that uses GregorianCalendar as the default calendar.
      outputBlock.Text += "CULTURE  A.D.   AD  C.E.    CE    CALENDAR                "
      outputBlock.Text += "CULTURE  A.D.   AD   C.E.   CE    CALENDAR" + vbCrLf + vbCrLf
      Dim ctr As Integer = 0
      For Each cultureName As String In cultureNames
         Dim culture As New CultureInfo(cultureName)
         Dim calendarName As String = culture.Calendar.ToString()
         calendarName = calendarName.Substring(calendarName.LastINdexOf("."c) + 1)
         outputBlock.Text += String.Format("{0,-10}", culture)
         outputBlock.Text += String.Format("{0,-6}{1,-6}", culture.DateTimeFormat.GetEra(strADPunc), culture.DateTimeFormat.GetEra(strADNoPunc))
         outputBlock.Text += String.Format("{0,-6}{1,-6}", culture.DateTimeFormat.GetEra(strCEPunc), culture.DateTimeFormat.GetEra(strCENoPunc))
         outputBlock.Text += String.Format("{0,-20}    ", calendarName)

         ctr += 1
         If ctr = 2 Then
            outputBlock.Text &= vbCrLf
            ctr = 0
         End If
      Next 
   End Sub  
End Class
' This example produces the following output:  
'    CULTURE  A.D.   AD  C.E.    CE    CALENDAR                CULTURE  A.D.   AD   C.E.   CE    CALENDAR
'    
'    ar-DZ     1     1     -1    -1    GregorianCalendar       ar-EG     1     1     -1    -1    GregorianCalendar       
'    ar-IQ     1     1     -1    -1    GregorianCalendar       ar-JO     1     1     -1    -1    GregorianCalendar       
'    ar-LB     1     1     -1    -1    GregorianCalendar       ar-LY     1     1     -1    -1    GregorianCalendar       
'    ar-MA     1     1     -1    -1    GregorianCalendar       ar-SA     -1    -1    -1    -1    HijriCalendar           
'    ar-SY     1     1     -1    -1    GregorianCalendar       ar-TN     1     1     -1    -1    GregorianCalendar       
'    be-BY     1     1     -1    -1    GregorianCalendar       bg-BG     1     1     -1    -1    GregorianCalendar       
'    cs-CZ     -1    -1    -1    -1    GregorianCalendar       da-DK     1     1     -1    -1    GregorianCalendar       
'    de-AT     -1    -1    -1    -1    GregorianCalendar       de-CH     -1    -1    -1    -1    GregorianCalendar       
'    de-DE     -1    -1    -1    -1    GregorianCalendar       dv-MV     -1    -1    -1    -1    HijriCalendar           
'    el-GR     -1    -1    -1    -1    GregorianCalendar       en-AU     1     1     -1    -1    GregorianCalendar       
'    en-CA     1     1     -1    -1    GregorianCalendar       en-GB     1     1     -1    -1    GregorianCalendar       
'    en-NZ     1     1     -1    -1    GregorianCalendar       en-US     1     1     -1    -1    GregorianCalendar       
'    es-AR     -1    -1    -1    -1    GregorianCalendar       es-BO     -1    -1    -1    -1    GregorianCalendar       
'    es-CL     -1    -1    -1    -1    GregorianCalendar       es-CO     -1    -1    -1    -1    GregorianCalendar       
'    es-EC     -1    -1    -1    -1    GregorianCalendar       es-ES     -1    -1    -1    -1    GregorianCalendar       
'    es-GT     -1    -1    -1    -1    GregorianCalendar       es-HN     -1    -1    -1    -1    GregorianCalendar       
'    es-MX     -1    -1    -1    -1    GregorianCalendar       es-NI     -1    -1    -1    -1    GregorianCalendar       
'    es-PE     -1    -1    -1    -1    GregorianCalendar       es-PY     -1    -1    -1    -1    GregorianCalendar       
'    es-VE     -1    -1    -1    -1    GregorianCalendar       fa-IR     1     1     -1    -1    GregorianCalendar       
'    fi-FI     1     1     -1    -1    GregorianCalendar       fr-BE     -1    -1    -1    -1    GregorianCalendar       
'    fr-FR     -1    -1    -1    -1    GregorianCalendar       he-IL     -1    -1    -1    -1    GregorianCalendar       
'    hi-IN     1     1     -1    -1    GregorianCalendar       hr-HR     1     1     -1    -1    GregorianCalendar       
'    hu-HU     -1    -1    -1    -1    GregorianCalendar       id-ID     1     1     -1    -1    GregorianCalendar       
'    is-IS     1     1     -1    -1    GregorianCalendar       it-IT     -1    -1    -1    -1    GregorianCalendar       
'    ja-JP     -1    -1    -1    -1    GregorianCalendar       ka-GE     1     1     -1    -1    GregorianCalendar       
'    ko-KR     -1    -1    -1    -1    GregorianCalendar       ms-MY     1     1     -1    -1    GregorianCalendar       
'    nl-NL     1     1     -1    -1    GregorianCalendar       nn-NO     1     1     -1    -1    GregorianCalendar       
'    pl-PL     1     1     -1    -1    GregorianCalendar       pt-BR     -1    -1    -1    -1    GregorianCalendar       
'    pt-PT     -1    -1    -1    -1    GregorianCalendar       ro-RO     1     1     -1    -1    GregorianCalendar       
'    ru-RU     1     1     -1    -1    GregorianCalendar       sa-IN     1     1     -1    -1    GregorianCalendar       
'    sk-SK     -1    -1    -1    -1    GregorianCalendar       sl-SI     1     1     -1    -1    GregorianCalendar       
'    sq-AL     1     1     -1    -1    GregorianCalendar       sv-SE     1     1     -1    -1    GregorianCalendar       
'    sw-KE     1     1     -1    -1    GregorianCalendar       syr-SY    1     1     -1    -1    GregorianCalendar       
'    ta-IN     1     1     -1    -1    GregorianCalendar       th-TH     -1    -1    -1    -1    ThaiBuddhistCalendar    
'    tr-TR     1     1     -1    -1    GregorianCalendar       uk-UA     1     1     -1    -1    GregorianCalendar       
'    ur-PK     1     1     -1    -1    GregorianCalendar       vi-VN     1     1     -1    -1    GregorianCalendar       
'    zh-CN     -1    -1    -1    -1    GregorianCalendar       zh-HK     1     1     -1    -1    GregorianCalendar       
'    zh-SG     1     1     -1    -1    GregorianCalendar       zh-TW     -1    -1    -1    -1    GregorianCalendar       


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

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

Community Additions

ADD
Show: