DateTime::DayOfWeek Property

 

Gets the day of the week represented by this instance.

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

public:
property DayOfWeek DayOfWeek {
	DayOfWeek get();
}

Property Value

Type: System::DayOfWeek

An enumerated constant that indicates the day of the week of this DateTime value.

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 (which indicates DayOfWeek::Sunday) to six (which indicates DayOfWeek::Saturday).

The DayOfWeek property returns an enumerated constant; it does not reflect a system's regional and language settings. To retrieve a string representing a localized weekday name for a particular date, call one of the overloads of the ToString method that includes a format parameter and pass it either the ddd or dddd custom format strings. For details, see How to: Extract the Day of the Week from a Specific Date.

The following example demonstrates the DayOfWeek property and the System::DayOfWeek enumeration.

// This example demonstrates the DateTime.DayOfWeek property
using namespace System;
int main()
{

   // Assume the current culture is en-US.
   // Create a DateTime for the first of May, 2003.
   DateTime dt = DateTime(2003,5,1);
   Console::WriteLine(  "Is Thursday the day of the week for {0:d}?: {1}", dt, dt.DayOfWeek == DayOfWeek::Thursday );
   Console::WriteLine(  "The day of the week for {0:d} is {1}.", dt, dt.DayOfWeek );
}

/*
This example produces the following results:

Is Thursday the day of the week for 5/1/2003?: True
The day of the week for 5/1/2003 is Thursday.
*/

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: