Weekday 函數

套用到
Microsoft 365 Access Access 2024 Access 2021 Access 2019 Access 2016

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

選擇合適的約會功能