DateValue 函数 （时间日期函数）

DateValue 函数

返回变量型（日期型）。

语法

DateValue(date)

date 参数 （参数:为操作、事件、方法、属性、函数或过程提供信息的值。）必选。该参数通常为表示 100 年 1 月 1 日到 9999 年 12 月 31 日之间日期的字符串表达式 （字符串表达式:任一求值为一列连续字符的表达式。表达式的元素可以是:返回字符串或字符串 Variant (VarType 8) 的函数；字符串字面值、常量、变量或 Variant。）。不过，date 也可以是可表示此范围内的日期和/或时间的任何表达式 （表达式:算术或逻辑运算符、常数、函数和字段名称、控件和属性的任意组合，计算结果为单个值。表达式可执行计算、操作字符或测试数据。）。

注解

如果 date 是字符串，且该字符串仅包含由有效日期分隔符 （日期分隔符:设置日期值格式时，用于分隔日、月和年的字符。这些字符由系统设置或通过使用 Format 函数决定。）分隔的数字，则 DateValue 会根据为系统指定的短日期格式识别月、日和年的顺序。DateValue 还会识别包含月份名的确定的日期（长格式或缩写形式）。例如，除识别“12/30/1991”和“12/30/91”外，DateValue 还可识别“December 30, 1991”和“Dec 30, 1991”。

如果省略了 date 的年份部分，DateValue 会使用计算机系统日期的当前年份。

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

 注释   对于 date，如果 Calendar 属性设置为公历，则提供的日期必须为公历。如果日历为回历，则提供的日期必须为回历。如果提供的日期为回历，则参数 date 为字符串型，该字符串表示从 1/1/100（公历 718 年 8 月 2 日）到 4/3/9666（公历 9999 年 12 月 31 日）之间的日期。

示例

 注释   以下示例演示了此功能在 Visual Basic for Applications (VBA) 模块中的使用。有关使用 VBA 的详细信息，请在“搜索”旁边的下拉列表中选择“开发人员参考”，然后在搜索框中输入一个或多个词条。

以下示例使用 DateValue 函数将字符串转换为日期。也可以使用日期文字将日期直接赋给变量型或日期型变量，例如，MyDate = #2/12/69#。

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