DateAndTime::Weekday Method (DateTime, FirstDayOfWeek)
Returns an Integer value containing a number representing the day of the week.
Assembly: Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)
public: static int Weekday( DateTime DateValue, FirstDayOfWeek DayOfWeek = FirstDayOfWeek::Sunday )
Parameters
- DateValue
-
Type:
System::DateTime
Required. Date value for which you want to determine the day of the week.
- DayOfWeek
-
Type:
Microsoft.VisualBasic::FirstDayOfWeek
Optional. A value chosen from the FirstDayOfWeek enumeration that specifies the first day of the week. If not specified, FirstDayOfWeek.Sunday is used.
Return Value
Type: System::Int32Returns an Integer value containing a number representing the day of the week.
| Exception | Condition |
|---|---|
| ArgumentException | DayOfWeek is less than 0 or more than 7. |
The value returned by the Weekday function corresponds to the values of the FirstDayOfWeek enumeration; that is, 1 indicates Sunday and 7 indicates Saturday.
Note |
|---|
Weekday uses the current calendar setting from the CurrentCulture property of the CultureInfo class in the System.Globalization namespace. The default CurrentCulture values are determined by Control Panel settings. |
The DayOfWeek argument can have one of the following settings.
Enumeration value | Value | Description |
|---|---|---|
FirstDayOfWeek.System | 0 | First day of week specified in system settings |
FirstDayOfWeek.Sunday | 1 | Sunday (default) |
FirstDayOfWeek.Monday | 2 | Monday (complies with ISO standard 8601, section 3.17) |
FirstDayOfWeek.Tuesday | 3 | Tuesday |
FirstDayOfWeek.Wednesday | 4 | Wednesday |
FirstDayOfWeek.Thursday | 5 | Thursday |
FirstDayOfWeek.Friday | 6 | Friday |
FirstDayOfWeek.Saturday | 7 | Saturday |
The following example uses the Weekday function to obtain the day of the week from a specified date.
Dim oldDate As Date Dim oldWeekDay As Integer oldDate = #2/12/1969# oldWeekDay = Weekday(oldDate) ' oldWeekDay now contains 4 because thisDate represents a Wednesday.
Available since 1.1
Silverlight
Available since 2.0
