TimeValue 函数

应用对象
Microsoft 365 专属 Access Access 2024 Access 2021 Access 2019 Access 2016

返回一个包含时间的 Variant (Date) 值。

语法

TimeValue (时间)

必需的 time参数通常是一个字符串表达式,表示从 0:00:00 (12:00:00 A.M.) 到 23:59:59 (11:59:59(包括下午 11:59:59)) (含)的时间。 但是, 时间 也可以是表示该范围内的时间的任何表达式。 如果 time 包含 Null,则返回 Null

备注

可以使用 12 小时制或 24 小时制输入有效时间。 例如, "2:24PM""14:24" 都是有效的 时间 参数。

如果 time 参数包含日期信息, 则 TimeValue 不会返回它。 但是,如果 时间 包含无效的日期信息,则会发生错误。

查询示例

Expression 结果
SELECT TimeValue ([DateTime]) AS Expr1 FROM ProductSales; 返回字段“DateTime”的时间值,而不返回日期信息,并显示在 Expr1 列中。
SELECT TimeValue ([DateTime]) AS JustTime FROM ProductSales; 返回字段“DateTime”的时间值,而不返回日期信息,并显示在 JustTime 列中。

VBA 示例

注意

下面的示例演示了如何在 Visual Basic for Applications (VBA) 模块中使用此函数。 有关使用 VBA 的详细信息,请在搜索旁边的下拉列表中选择“开发人员参考”,并在搜索框中输入一个或多个术语。

此示例使用 TimeValue 函数将字符串转换为时间。 还可以使用日期文本直接将时间分配给 VariantDate 变量,例如 MyTime = #4:35:17 PM#。

Dim MyTime
MyTime = TimeValue("4:35:17 PM")    ' Return a time.

选择正确的日期函数