傳回 (日期) 的變體。
語法
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.