UmAlQuraCalendar.GetEra Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Updated: October 2010
Returns the era of a specified DateTime value.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Overrides Function GetEra ( _
time As DateTime _
) As Integer
public override int GetEra(
DateTime time
)
Parameters
- time
Type: System.DateTime
The date to read.
Return Value
Type: System.Int32
Always returns the CurrentEra value.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | time is outside the range supported by this calendar. |
Remarks
The Hijri calendar recognizes one era: A.H. (Latin "Anno Hegirae", which means "the year of the migration," in reference to the migration of Muhammad from Mecca).
Examples
The following example displays the values of several components of a date in the Um Al Qura calendar.
Imports System.Globalization
Module Example
Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
Dim date1 As Date = New Date(2011, 4, 3, New GregorianCalendar())
Dim cal As New UmAlQuraCalendar()
outputBlock.Text &= String.Format("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:",
date1) & vbCrLf
DisplayCalendarInfo(outputBlock, cal, date1)
' Add 2 years and 10 months by calling UmAlQuraCalendar methods.
date1 = cal.AddYears(date1, 2)
date1 = cal.AddMonths(date1, 10)
outputBlock.Text += String.Format("After adding 2 years and 10 months in the {0} calendar,",
GetCalendarName(cal)) & vbCrLf
outputBlock.Text &= String.Format("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:",
date1) & vbCrLf
DisplayCalendarInfo(outputBlock, cal, date1)
End Sub
Private Sub DisplayCalendarInfo(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal cal As Calendar, ByVal date1 As Date)
outputBlock.Text += String.Format(" Calendar: {0}", GetCalendarName(cal)) & vbCrLf
outputBlock.Text += String.Format(" Era: {0}", cal.GetEra(date1)) & vbCrLf
outputBlock.Text += String.Format(" Year: {0}", cal.GetYear(date1)) & vbCrLf
outputBlock.Text += String.Format(" Month: {0}", cal.GetMonth(date1)) & vbCrLf
outputBlock.Text += String.Format(" DayOfYear: {0}", cal.GetDayOfYear(date1)) & vbCrLf
outputBlock.Text += String.Format(" DayOfMonth: {0}", cal.GetDayOfMonth(date1)) & vbCrLf
outputBlock.Text += String.Format(" DayOfWeek: {0}", cal.GetDayOfWeek(date1)) & vbCrLf
outputBlock.Text &= vbCrLf
End Sub
Private Function GetCalendarName(ByVal cal As Calendar) As String
Return cal.ToString().Replace("System.Globalization.", "").
Replace("Calendar", "")
End Function
End Module
' The example displays the following output:
' April 3, 2011 in the Gregorian calendar is equivalent to:
' Calendar: UmAlQura
' Era: 1
' Year: 1432
' Month: 4
' DayOfYear: 118
' DayOfMonth: 29
' DayOfWeek: Sunday
'
' After adding 2 years and 10 months in the UmAlQura calendar,
' January 1, 2014 in the Gregorian calendar is equivalent to:
' Calendar: UmAlQura
' Era: 1
' Year: 1435
' Month: 2
' DayOfYear: 59
' DayOfMonth: 29
' DayOfWeek: Wednesday
using System;
using System.Globalization;
public class Example
{
public static void Demo(System.Windows.Controls.TextBlock outputBlock)
{
DateTime date1 = new DateTime(2011, 4, 3, new GregorianCalendar());
Calendar cal = new UmAlQuraCalendar();
outputBlock.Text += String.Format("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:\n",
date1);
DisplayCalendarInfo(outputBlock, cal, date1);
// Add 2 years and 10 months by calling UmAlQuraCalendar methods.
date1 = cal.AddYears(date1, 2);
date1 = cal.AddMonths(date1, 10);
outputBlock.Text += String.Format("After adding 2 years and 10 months in the {0} calendar,\n",
GetCalendarName(cal));
outputBlock.Text += String.Format("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:\n",
date1);
DisplayCalendarInfo(outputBlock, cal, date1);
}
private static void DisplayCalendarInfo(System.Windows.Controls.TextBlock outputBlock, Calendar cal, DateTime date1)
{
outputBlock.Text += String.Format(" Calendar: {0}", GetCalendarName(cal)) + "\n";
outputBlock.Text += String.Format(" Era: {0}", cal.GetEra(date1)) + "\n";
outputBlock.Text += String.Format(" Year: {0}", cal.GetYear(date1)) + "\n";
outputBlock.Text += String.Format(" Month: {0}", cal.GetMonth(date1)) + "\n";
outputBlock.Text += String.Format(" DayOfYear: {0}", cal.GetDayOfYear(date1)) + "\n";
outputBlock.Text += String.Format(" DayOfMonth: {0}", cal.GetDayOfMonth(date1)) + "\n";
outputBlock.Text += String.Format(" DayOfWeek: {0}\n", cal.GetDayOfWeek(date1)) + "\n";
}
private static string GetCalendarName(Calendar cal)
{
return cal.ToString().Replace("System.Globalization.", "").
Replace("Calendar", "");
}
}
// The example displays the following output:
// April 3, 2011 in the Gregorian calendar is equivalent to:
// Calendar: UmAlQura
// Era: 1
// Year: 1432
// Month: 4
// DayOfYear: 118
// DayOfMonth: 29
// DayOfWeek: Sunday
//
// After adding 2 years and 10 months in the UmAlQura calendar,
// January 1, 2014 in the Gregorian calendar is equivalent to:
// Calendar: UmAlQura
// Era: 1
// Year: 1435
// Month: 2
// DayOfYear: 59
// DayOfMonth: 29
// DayOfWeek: Wednesday
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.
Change History
Date |
History |
Reason |
|---|---|---|
October 2010 |
Replaced the example. |
Customer feedback. |