Share via


DateTimeOffset.DayOfWeek Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets the day of the week represented by the current DateTimeOffset object.

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

Syntax

'Declaration
Public ReadOnly Property DayOfWeek As DayOfWeek
public DayOfWeek DayOfWeek { get; }

Property Value

Type: System.DayOfWeek
One of the enumeration values that indicates the day of the week of the current DateTimeOffset object.

Remarks

The value of the constants in the DayOfWeek enumeration ranges from DayOfWeek.Sunday to DayOfWeek.Saturday. If cast to an integer, its value ranges from zero (indicating DayOfWeek.Sunday) to six (indicating DayOfWeek.Saturday).

You can also display the weekday name of a particular date by using the "D" format specifier or the "dddd" custom format specifier. For example:

Dim displayDate As New DateTimeOffset(#1/1/2008 1:18:00 PM#, _
                                      DateTimeOffset.Now.Offset)
outputBlock.Text &= String.Format("{0:D}", displayDate) & vbCrLf    ' Output: Tuesday, January 01, 2008                     
outputBlock.Text &= String.Format("{0:d} is a {0:dddd}.", _
                  displayDate)             ' Output: 1/1/2008 is a Tuesday. & vbCrLf
DateTimeOffset displayDate = new DateTimeOffset(2008, 1, 1, 13, 18, 00,
                                                DateTimeOffset.Now.Offset);
outputBlock.Text += String.Format("{0:D}", displayDate) + "\n";  // Output: Tuesday, January 01, 2008                     
outputBlock.Text += String.Format("{0:d} is a {0:dddd}.",
                  displayDate) + "\n";           // Output: 1/1/2008 is a Tuesday.

Note that the string returned by calling the ToString method of the DayOfWeek enumeration member that is returned by this property is not localized. To extract a string that contains the weekday name of the current culture or of a specific culture, call the ToString method with the "dddd" custom format specifier. For example, the following code displays the weekday name for a date using the fr-fr culture.

Dim thisDate As New DateTimeOffset(#6/1/2007 6:15:00 AM#, _
                                      DateTimeOffset.Now.Offset)
Dim weekdayName As String = thisDate.ToString("dddd", _
                            New CultureInfo("fr-fr"))
outputBlock.Text &= weekdayName & vbCrLf                        ' Displays vendredi     
DateTimeOffset thisDate = new DateTimeOffset(2007, 6, 1, 6, 15, 0,
                                             DateTimeOffset.Now.Offset);
string weekdayName = thisDate.ToString("dddd",
                                       new CultureInfo("fr-fr"));
outputBlock.Text += weekdayName + "\n";                  // Displays vendredi     

Examples

The following example displays the weekday name of the first day of each month of the year 2008.

Dim startOfMonth As New DateTimeOffset(#1/1/2008#, _
                                      DateTimeOffset.Now.Offset)
Dim year As Integer = startOfMonth.Year
Do While startOfMonth.Year = year
   outputBlock.Text &= String.Format("{0:MMM d, yyyy} is a {1}.", _
                     startOfMonth, startOfMonth.DayOfWeek) & vbCrLf
   startOfMonth = startOfMonth.AddMonths(1)
Loop
' This example writes the following output:
'    Jan 1, 2008 is a Tuesday.
'    Feb 1, 2008 is a Friday.
'    Mar 1, 2008 is a Saturday.
'    Apr 1, 2008 is a Tuesday.
'    May 1, 2008 is a Thursday.
'    Jun 1, 2008 is a Sunday.
'    Jul 1, 2008 is a Tuesday.
'    Aug 1, 2008 is a Friday.
'    Sep 1, 2008 is a Monday.
'    Oct 1, 2008 is a Wednesday.
'    Nov 1, 2008 is a Saturday.
'    Dec 1, 2008 is a Monday.      
DateTimeOffset startOfMonth = new DateTimeOffset(2008, 1, 1, 0, 0, 0,
                                         DateTimeOffset.Now.Offset);
int year = startOfMonth.Year;
do
{
   outputBlock.Text += String.Format("{0:MMM d, yyyy} is a {1}.", startOfMonth, startOfMonth.DayOfWeek) + "\n";
   startOfMonth = startOfMonth.AddMonths(1);
}
while (startOfMonth.Year == year);
// This example writes the following output:
//    Jan 1, 2008 is a Tuesday.
//    Feb 1, 2008 is a Friday.
//    Mar 1, 2008 is a Saturday.
//    Apr 1, 2008 is a Tuesday.
//    May 1, 2008 is a Thursday.
//    Jun 1, 2008 is a Sunday.
//    Jul 1, 2008 is a Tuesday.
//    Aug 1, 2008 is a Friday.
//    Sep 1, 2008 is a Monday.
//    Oct 1, 2008 is a Wednesday.
//    Nov 1, 2008 is a Saturday.
//    Dec 1, 2008 is a Monday.      

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.