DateTimeFormatInfo.GetEra Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Returns the integer representing the specified era name.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Function GetEra ( _
eraName As String _
) As Integer
public int GetEra(
string eraName
)
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.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | eraName is nulla null reference (Nothing in Visual Basic). |
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.
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
.png "Silverlight for Windows Phone"){kind=icon}
Silverlight for Windows Phone
This member returns -1 for the fr-FR culture.
Examples
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
using System;
using System.Globalization;
using System.Windows.Media;
public class Example
{
public static void Demo(System.Windows.Controls.TextBlock outputBlock)
{
// Create an array containing selected culture names.
string[] cultureNames = { "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.
String strADPunc = "A.D.";
String strADNoPunc = "AD";
String strCEPunc = "C.E.";
String strCENoPunc = "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 \n\n";
int ctr = 0;
foreach (string cultureName in cultureNames)
{
CultureInfo culture = new CultureInfo(cultureName);
string calendarName = culture.Calendar.ToString();
calendarName = calendarName.Substring(calendarName.LastIndexOf('.') + 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++;
if (ctr == 2)
{
outputBlock.Text += "\n";
ctr = 0;
}
}
}
}
/*
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
*/
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.