傳回 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 屬性 設定為公曆，傳回的整數代表日期自變數的公曆星期幾。 如果行事曆是回歷，傳回的整數代表日期自變數的每周回歷日。 對於回歷日期，自變數數位是任何可代表公曆 1/1/100 (公曆 718 年) 8 月 2 日到 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.
