傳回 Variant (Date) 。
語法
DateValue ( date )
所需 日期引數 通常是代表 100 年 1 月 1 日到 9999 年 12 月 31 日日期的 字串運算式 。 不過, 日期 也可以是任何可代表該範圍內日期、時間或日期和時間的 運算式 。
註解
如果 date 是只包含以有效 日期分隔符號分隔之數位的字串, DateValue 會 根據您為系統指定的簡短日期格式來辨識月份、日和年的順序。 DateValue 也可辨識包含月份名稱的明確日期,無論是長或縮寫形式。 例如,除了辨識 12/30/1991 和 12/30/91 之外, DateValue 也會辨識 1991 年 12 月 30 日和 1991 年 12 月 30 日。
如果省略 日期 的年份, DateValue 會 使用您計算機系統日期的目前年份。
如果 日期自變數 包含時間資訊, DateValue 不會傳回。 不過,如果 date 包含無效的時間資訊 (例如 「89:98」) ,則會發生錯誤。
附註: 針對 日期,如果 [ 行事曆 ] 屬性設定為 [公曆],則所提供日期必須為公曆。 如果行事曆是回歷,則所提供的日期必須是回歷。 如果提供日期為Hijri,自變數日期為 String,代表從1/1/1/100 (公曆718年8月2日到4/3/9666) (公曆 9999年12月31日) 日期。
查詢範例
Expression |
結果 |
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 函數將字串轉換成日期。 您也可以使用日期常值,直接將日期指派給 Variant 或 Date 變數,例如 MyDate = #2/12/69#。
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.