回傳日期 (變體) 。
語法
DateValue (日期)
所需的日期參數通常是字串表達式,代表從100年1月1日至9999年12月31日的日期。 然而, 日期 也可以是任何表達式,該表達式在該範圍內代表日期、時間,或同時是日期與時間。
註解
如果 日期 是只包含數字且以有效日期分隔符分隔的字串, DateValue 會依照你為系統指定的短日期格式,辨識月份、日、年的順序。 DateValue 也能辨識包含月份名稱的明確日期,無論是長名稱或縮寫形式。 例如,除了辨識1991年12月30日和12月30日外, DateValue 也識別1991年12月30日和1991年12月30日。
如果省略 年份 部分, DateValue 會使用你電腦系統日期的當前年份。
如果 日期 參數包含時間資訊, DateValue 不會回傳時間資訊。 然而,若 日期 包含 (如「89:98」) 等無效時間資訊,則會發生錯誤。
注意
關於日期,若 Calendar 屬性設定為格里曆,則所提供的日期必須是格里曆。 如果曆法是伊斯蘭曆,則所提供的日期必須是伊斯蘭曆。 若提供的日期為伊斯蘭曆,則參數 日期 為一 串 ,代表100年1月1日 () 718年8月2日至9666年4月3日 (9999年12月31日) 日期。
查詢範例
| 運算式 | 結果 |
|---|---|
| SELECT DateValue ([DateTime]) 作為 Expr1 來自 ProductSales; | 回傳「DateTime」欄位的日期值,採用簡短日期格式,但不含時間資訊。 |
| 選擇日期值 ([DateTime]) 作為 NewDate,計數 (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.