UmAlQuraCalendar.GetDayOfWeek Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Calculates on which day of the week a specified date occurs.

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

Syntax

Public Overrides Function GetDayOfWeek ( _
    time As DateTime _
) As DayOfWeek
public override DayOfWeek GetDayOfWeek(
    DateTime time
)

Parameters

Return Value

Type: System..::.DayOfWeek
The day of the week specified by the time parameter.

Exceptions

Exception Condition
ArgumentOutOfRangeException

time is outside the range supported by this calendar.

Remarks

The DayOfWeek values are as follows:

DayOfWeek value

which indicates

Sunday

الاحد (Al-Ahad)

Monday

الاثنين (Al-Ithnayn)

Tuesday

الثلاثاء (At-Thulaathaa')

Wednesday

الاربعاء (Al-Arbi'aa')

Thursday

الخميس (Al-Khamiis)

Friday

الجمعة (Al-Jumu'ah)

Saturday

السبت (As-Sabt)

Examples

The following example displays the values of several components of a DateTime in terms of the Um Al Qura calendar.

Imports System.Globalization

Module Example
   Private outputBlock As System.Windows.Controls.TextBlock
   Public Sub Demo(outputBlock As System.Windows.Controls.TextBlock)
      Example.outputBlock = outputBlock
      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) + Environment.NewLine
      DisplayCalendarInfo(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)) + Environment.NewLine
      outputBlock.Text += String.Format("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1) + Environment.NewLine
      DisplayCalendarInfo(cal, date1)
   End Sub

   Private Sub DisplayCalendarInfo(cal As Calendar, date1 As Date)
      outputBlock.Text += String.Format("   Calendar:   {0}", GetCalendarName(cal)) + Environment.NewLine    
      outputBlock.Text += String.Format("   Era:        {0}", cal.GetEra(date1)) + Environment.NewLine
      outputBlock.Text += String.Format("   Year:       {0}", cal.GetYear(date1)) + Environment.NewLine
      outputBlock.Text += String.Format("   Month:      {0}", cal.GetMonth(date1)) + Environment.NewLine
      outputBlock.Text += String.Format("   DayOfYear:  {0}", cal.GetDayOfYear(date1)) + Environment.NewLine
      outputBlock.Text += String.Format("   DayOfMonth: {0}", cal.GetDayOfMonth(date1)) + Environment.NewLine
      outputBlock.Text += String.Format("   DayOfWeek:  {0}", cal.GetDayOfWeek(date1)) + Environment.NewLine
      outputBlock.Text +=  Environment.NewLine
   End Sub

   Private Function GetCalendarName(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
{
   private static System.Windows.Controls.TextBlock outputBlock;

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      Example.outputBlock = 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:", date1) + Environment.NewLine;
      DisplayCalendarInfo(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)) + Environment.NewLine;
      outputBlock.Text += String.Format("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1) + Environment.NewLine;
      DisplayCalendarInfo(cal, date1);
   }

   private static void DisplayCalendarInfo(Calendar cal, DateTime date1)
   {
      outputBlock.Text += String.Format("   Calendar:   {0}", GetCalendarName(cal)) + Environment.NewLine;    
      outputBlock.Text += String.Format("   Era:        {0}", cal.GetEra(date1)) + Environment.NewLine;
      outputBlock.Text += String.Format("   Year:       {0}", cal.GetYear(date1)) + Environment.NewLine;
      outputBlock.Text += String.Format("   Month:      {0}", cal.GetMonth(date1)) + Environment.NewLine;
      outputBlock.Text += String.Format("   DayOfYear:  {0}", cal.GetDayOfYear(date1)) + Environment.NewLine;
      outputBlock.Text += String.Format("   DayOfMonth: {0}", cal.GetDayOfMonth(date1)) + Environment.NewLine;
      outputBlock.Text += String.Format("   DayOfWeek:  {0}\n", cal.GetDayOfWeek(date1)) + Environment.NewLine;
   }

   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

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

UmAlQuraCalendar Class

System.Globalization Namespace

DateTime..::.DayOfWeek

System..::.DayOfWeek