返回一个 Variant (Integer) 值,其中包含表示星期几的整数。
语法
Weekday (date [, 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 属性设置为公历,则返回的整数表示日期参数的公历星期几。 如果日历是回历,则返回的整数表示日期参数的回历一周中的某一天。 对于回历日期,参数编号是任何数字表达式,可用于表示从 100/1/1 (公历 718) 到 4/3/9666 (公历 9999 年 12 月 31 日) 的日期和/或时间。
查询示例
| 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.