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 中)