傳回 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.