返回一个 Variant (Integer) 值,其中包含表示星期几的整数。
语法
工作日 ( 日期 [, firstdayofweek ] )
Weekday 函数语法具有以下参数:
参数 |
说明 |
date |
必需。 Variant、 数值表达式 、 字符串表达式 或可表示日期的任意组合。 如果 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.