• Article

DateAndTime.Weekday Method

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

Returns an Integer value containing a number representing the day of the week.

Namespace:  Microsoft.VisualBasic
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

Syntax

'Declaration
Public Shared Function Weekday ( _
    DateValue As DateTime, _
    DayOfWeek As FirstDayOfWeek _
) As Integer

public static int Weekday(
    DateTime DateValue,
    FirstDayOfWeek DayOfWeek
)

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.Int32
Returns an Integer value containing a number representing the day of the week.

Remarks

The value returned by the Weekday function corresponds to the values of the FirstDayOfWeek enumeration; that is, 1 indicates Sunday and 7 indicates Saturday.

NoteNote:

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

Examples

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.

Version Information

Silverlight

Supported in: 5, 4, 3

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.