Weekday Function

Applies to: Access for Microsoft 365, Access 2019, Access 2016, Access 2013, Access 2010, Access 2007.

Returns a Variant (Integer) containing a whole number representing the day of the week.

Syntax

Weekday( date [firstdayofweek ] )

The Weekday function syntax has these arguments:

ArgumentDescription
dateRequired. Variant, numeric expression, string expression, or any combination of these that can represent a date. If date contains Null, Null is returned.
firstdayofweekOptional. A constant that specifies the first day of the week. If not specified, vbSunday is assumed.

Settings

The firstdayofweek argument has these settings:

ConstantValueDescription
vbUseSystem0Use the NLS API setting.
vbSunday1Sunday (default)
vbMonday2Monday
vbTuesday3Tuesday
vbWednesday4Wednesday
vbThursday5Thursday
vbFriday6Friday
vbSaturday7Saturday

Return Values

The Weekday function can return any of these values:

ConstantValueDescription
vbSunday1Sunday
vbMonday2Monday
vbTuesday3Tuesday
vbWednesday4Wednesday
vbThursday5Thursday
vbFriday6Friday
vbSaturday7Saturday

Remarks

If the Calendar property setting is Gregorian, the returned integer represents the Gregorian day of the week for the date argument. If the calendar is Hijri, the returned integer represents the Hijri day of the week for the date argument. For Hijri dates, the argument number is any numeric expression that can represent a date and/or time from 1/1/100 (Gregorian Aug 2, 718) through 4/3/9666 (Gregorian Dec 31, 9999).

Query examples

ExpressionResults
SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales;Returns the values from the field “DateofSale” and number representing the ‘Weekday’ of these date values. (By default Sunday is considered the first day of the week; 1).
SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales;Returns the values from the field “DateofSale” and number representing the ‘Weekday’ of these date values. (considering Monday as first day of the week).

VBA example

Note: Examples that follow demonstrate the use of this function in a Visual Basic for Applications (VBA) module. For more information about working with VBA, select Developer Reference in the drop-down list next to Search and enter one or more terms in the search box.

This example uses the Weekday function to obtain the day of the week from a specified date.

Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.

See Also

Choose the right date function

This information was compiled using information courtesy of © Microsoft 2020. All rights reserved.

Leave a Reply

%d bloggers like this: