DateValue 函數

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

傳回 (日期) 的變體

語法

DateValue (日期)

required date引數通常是字串運算式,表示 100 年 1 月 1 日到 9999 年 12 月 31 日之間的日期。 不過, date 也可以是該範圍內可以代表日期、時間或日期和時間的任何運算式。

註解

如果 date 是一個字串,其中只包含以有效日期分隔符號分隔的數字, 則 DateValue 會根據您為系統指定的簡短日期格式來辨識月、日和年的順序。 DateValue 也可以辨識包含月份名稱的明確日期,不論是長或縮寫形式。 例如,除了辨識 12/30/1991 和 12/30/ 91,DateValue 除了辨識 1991 年 12 月 30 日和 1991 年 12 月 30 日。

如果 省略 Date 的年份部分, DateValue 會使用您電腦系統日期之後的目前年份。

如果 date 引數包含時間資訊, DateValue 不會傳回。 不過,如果 日期 包含無效的時間資訊 (,例如 “89:98”) ,則會發生錯誤。

注意

針對日期,如果 Calendar 屬性設定為 Gregorian,則提供的日期必須是 Gregorian。 如果日曆是回曆,則提供的日期必須是回曆。 如果提供的日期為回曆,則引數 日期 是一個 字串 ,表示西曆 718 年 8 月 2 日 (100 年 4 月 3 日) 西曆 9999 年 12 月 31 日 () 的日期。

查詢範例

運算式 結果
SELECT DateValue ([DateTime]) AS Expr1 FROM ProductSales; 以簡短日期格式傳回 “DateTime” 欄位的日期值,但不含時間資訊。
SELECT DateValue ([DateTime]) AS NewDate, Count (ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue ([DateTime]) ; 以簡短日期格式傳回 “DateTime” 欄位的日期值,但不含時間資訊。

VBA 範例

注意

下列範例示範如何在 Visual Basic for Applications (VBA) 模組中使用此函數。 如需使用 VBA 的詳細資訊,請在 [搜尋] 旁的下拉式清單中選取 [開發人員參考],並在 [搜尋] 方塊中輸入一個或多個字詞。

此範例使用 DateValue 函數將字串轉換成日期。 您也可以使用日期常值直接將日期指派給 變體日期 變數,例如 MyDate = #2/12/69#。

Dim MyDate
MyDate = DateValue("February 12, 1969")    ' Return a date.

選擇適當的日期函數