Weekday 函數

傳回 Variant (Integer)，包含代表星期名稱的整數。

語法

Weekday (date [， firstdayofweek ] )

Weekday 函數語法具有下列引數：

引數	描述
日期	必要。 變體、數值運算式、字串運算式或這些可代表日期的任何組合。 如果 日期 包含 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 屬性設定為西曆，則傳回的整數代表日期引數的西曆星期幾。 如果行事曆是回曆，則傳回的整數代表日期引數的回曆星期幾。 若是回曆日期，引數數字是可以表示從西曆 8 月 2 日 718 年 1 月 (1 日到 9666 年 4 月 3 日) (公曆 9999 年 12 月 31 日) 的日期和/或時間的任何數字運算式。

查詢範例

運算式	結果
SELECT DateofSale， Weekday ([DateofSale]) AS Expr1 FROM ProductSales;	傳回 “DateofSale” 欄位中的值，以及代表這些日期值的 'Weekday' 數字。 (根據預設，星期日會被視為一週的第一天;1) 。
SELECT DateofSale， Weekday ([DateofSale]，2) AS NewWeekDay FROM ProductSales;	傳回 “DateofSale” 欄位中的值，以及代表這些日期值的 'Weekday' 數字。 (考慮將星期一視為一週的第一天) 。

VBA 範例

此範例使用 Weekday 函數從指定日期取得星期幾。

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

選擇適當的日期函數