傳回 Variant (Integer),包含代表星期名稱的整數。
語法
平日 (日期 [, 週一 ] )
平日函數語法包含以下論點:
| 引數 | 描述 |
|---|---|
| 日期 | 必要。 變體、數值表達式、字串式,或這些組合,能代表日期。 若 日期 包含 Null,則回傳 Null 。 |
| 週第一天 | 可省略。 一個固定的恆定,標示著一週的第一天。 若未特別說明,則假設為 vbSunday 。 |
設定
「第一天」論證的設定如下:
| 恆定 | 值 | 描述 |
|---|---|---|
| vbUseSystem | 0 | 使用 NLS API 設定。 |
| vb星期日 | 1 | 星期天 (預設) |
| VB星期一 | 2 | 星期一 |
| vb星期二 | 3 | 星期二 |
| vb星期三 | 4 | 星期三 |
| vb星期四 | 5 | 星期四 |
| vb星期五 | 6 | 星期五 |
| vb星期六 | 7 | 星期六 |
回報價值
Weekday 函數可回傳以下任一值:
| 恆定 | 值 | 描述 |
|---|---|---|
| vb星期日 | 1 | 星期日 |
| VB星期一 | 2 | 星期一 |
| vb星期二 | 3 | 星期二 |
| vb星期三 | 4 | 星期三 |
| vb星期四 | 5 | 星期四 |
| vb星期五 | 6 | 星期五 |
| vb星期六 | 7 | 星期六 |
註解
若 Calendar 屬性設定為格里曆,回傳整數代表日期論元中的格里曆星期。 若曆法為伊斯蘭曆,則回傳整數代表日期論證的伊斯蘭曆星期幾。 對於伊斯蘭曆日期,參數編號是指任何能代表從100年1月1日 (71) 8年8月2日到9999年12月31日格里曆) 1月1日 (9666年4月3日的日期和/或時間的數字表達式。
查詢範例
| 運算式 | 結果 |
|---|---|
| 選擇銷售日期,平日 ([銷售日期]) 來源:ProductSales; | 回傳「DateofSale」欄位的值,以及代表這些日期值的「平日」數字。 (預設週日被視為一週的第一天;1) 。 |
| 選擇銷售日期,平日 ([銷售日期],2) 作為 NewWeekDay 取自 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.