共用方式為

DateValue 函式

  • 發行項

會傳回 Variant (Date) 。

語法

日期值 (日期)

必要的 date 自變數通常是字串表示式，代表從 100 年 1 月 1 日到 9999 年 12 月 31 日的日期。 不過， date 也可以是該範圍內可以代表日期、時間或日期和時間的任何 表達 式。

註解

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

如果省略 日期 的年份， DateValue 會 使用您計算機系統日期的目前年份。

如果 date 自變數 包含時間資訊， DateValue 就不會傳回它。 不過，如果 date 包含無效的時間資訊 (例如 「89：98」) ，則會發生錯誤。

注意事項

對於 date，如果 Calendar 屬性設定為西曆，提供的日期也必須是西曆。 如果行事曆為回曆，那麼提供的日期也必須是回曆。 如果提供的日期是Hijri，則自變數 日期 是 String ，代表公曆 9999 年 12 月 2 日 1/1/1/100 (718) 到 4/3/9666 (公曆 9999 年 12 月 31 日之間的日期) 。

範例

這個範例會使用 DateValue 函式將字串轉換成日期。 您也可以使用日期常值，直接將日期指派給 Variant 或 Date 變數，例如 MyDate = #2/12/69#。

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

另請參閱

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。