TimeValue 函数 (Visual Basic)
更新：2007 年 11 月
返回一个 Date 值，该值包含以字符串表示的时间信息，其日期信息设置为元年 1 月 1 日。
Public Function TimeValue(ByVal StringTime As String) As DateTime
参数
- StringTime
必选。String 表达式，表示自元年 1 月 1 日 00:00:00 到 9999 年 12 月 31 日 23:59:59 之间的日期/时间值。
异常
异常类型 |
错误号 |
条件 |
|---|---|---|
StringTime 包含无效的日期信息。 |
如果正在升级使用无结构错误处理的 Visual Basic 6.0 应用程序，请参见“错误号”一列。（您可以根据 Number 属性（Err 对象）比较错误号。）然而，如果可能，应当考虑用 Visual Basic 的结构化异常处理概述 替换这种错误控制。
备注
可以用 12 小时制或 24 小时制的时间格式来输入有效时间。例如，"2:24 P.M." 和 "14:24" 都是有效的 StringTime 参数。
若 StringTime 参数包括日期信息，则 TimeValue 不会将其纳入返回的值。但是，如果 StringTime 包含无效的数据信息（如“January 32,”），则会出现 InvalidCastException 错误。
示例
下面的示例使用 TimeValue 函数将字符串转换为时间。也可以使用日期文本直接将时间分配给 Date 变量。
Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")
要求
**模块：**DateAndTime
**程序集：**Visual Basic 运行库（在 Microsoft.VisualBasic.dll 中）