Weekday 函数
应用对象
Microsoft 365 专属 Access Access 2024 Access 2021 Access 2019 Access 2016
返回一个 Variant (Integer) 值，其中包含表示星期几的整数。
语法
工作日 (日期 [， firstdayofweek ] )
Weekday 函数语法具有以下参数：
| 参数 | 说明 |
|---|---|
| 日期 | 必需。 变量、数值表达式、字符串表达式或可表示日期的任意组合。 如果 date 包含 Null，则返回 Null 。 |
| firstdayofweek | 可选。 一个指定一周的第一天的常量。 如果未指定，则假定 为 vbSunday 。 |
“设置”
firstdayofweek 参数具有以下设置：
| 不断 | 值 | 说明 |
|---|---|---|
| vbUseSystem | 0 | 使用 NLS API 设置。 |
| vbSunday | 1 | 周日 (默认) |
| vbMonday | 2 | 星期一 |
| vbTuesday | 3 | 星期二 |
| vbWednesday | 4 | 星期三 |
| vbThursday | 5 | 星期四 |
| vbFriday | 6 | 星期五 |
| vbSaturday | 7 | 星期六 |
返回值
Weekday 函数可以返回以下任何值：
| 不断 | 值 | 说明 |
|---|---|---|
| vbSunday | 1 | 星期日 |
| vbMonday | 2 | 星期一 |
| vbTuesday | 3 | 星期二 |
| vbWednesday | 4 | 星期三 |
| vbThursday | 5 | 星期四 |
| vbFriday | 6 | 星期五 |
| vbSaturday | 7 | 星期六 |
备注
如果 Calendar 属性设置为 Gregorian，则返回的整数表示日期参数的公历星期几。 如果日历为 Hijri，则返回的整数表示日期参数的星期几。 对于 Hijri 日期，参数编号是可以表示从 1/1/100 (公历 8 月 2 日) 到 4/3/9666 (公历 12 月 31 日、9999) 的日期和/或时间的任何数值表达式。
查询示例
| Expression | 结果 |
|---|---|
| SELECT DateofSale， Weekday ([DateofSale]) AS Expr1 FROM ProductSales; | 返回字段“DateofSale”中的值，以及表示这些日期值的“工作日”的数字。 (默认情况下，星期日被视为一周的第一天;1) 。 |
| SELECT DateofSale， Weekday ([DateofSale]，2) AS NewWeekDay FROM ProductSales; | 返回字段“DateofSale”中的值，以及表示这些日期值的“工作日”的数字。 (考虑星期一作为一周的第一天) 。 |
VBA 示例
注意
下面的示例演示了如何在 Visual Basic for Applications (VBA) 模块中使用此函数。 有关使用 VBA 的详细信息，请在搜索旁边的下拉列表中选择“开发人员参考”，并在搜索框中输入一个或多个术语。
此示例使用 Weekday 函数获取指定日期中的星期几。
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.