DateValue 函数

  • 项目

返回一个 Variant (Date)。

语法

DateValue (date)

所需的 date参数 通常是表示从 100 年 1 月 1 日到 9999 年 12 月 31 日的 日期的字符串表达式 。 但是，date 还可是任何表示该范围内的日期、时间或日期和时间的表达式。

备注

如果 date 是仅包含由有效 日期分隔符分隔的数字的字符串， 则 DateValue 将根据为系统指定的短日期格式识别月份、日和年的顺序。 DateValue 还能清楚地识别包含月名称（长名称或简写形式）的日期。 例如，除了识别 12/30/1991 和 12/30/91 之外，DateValue 还识别 December 30, 1991 和 Dec 30, 1991。

如果省略 date 的年部分，则 DateValue 将使用计算机系统日期中的当前年。

如果 date 参数包含时间信息，则 DateValue 将不会返回它。 但是，如果 date 包含的时间信息无效（如“89:98”），则将出错。

注意

对于 date，如果 Calendar 属性设置为公历，则提供的日期必须为公历。 如果日历为回历，则提供的日期必须为回历。 如果提供的日期为回历，则参数 date 为表示 1/1/100（公历 718 年 8 月 2 日）到 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 支持和反馈，获取有关如何接收支持和提供反馈的指南。