返回日期) (变体。
语法
DateValue (日期)
必需日期参数通常是表示 9999 年 1 月 1 日到 12 月 31 日之间的日期的字符串表达式。 但是, date 也可以是可以表示该范围内的日期、时间或日期和时间的任何表达式。
备注
如果 date 是一个字符串,其中只包含用有效日期分隔符分隔的数字,则 DateValue 将根据为系统指定的短日期格式识别月、日和年的顺序。 DateValue 还可以识别包含月份名称的明确日期,可以是长月份名称还是缩写月份名称。 例如,除了识别 1991 年 12 月 30 日和 91 年 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 日) 。
查询示例
| 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 函数将字符串转换为日期。 还可以使用日期文本直接将日期赋值给 变体 或 日期 变量,例如 MyDate = #2/12/69#。
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.