DateAndTime.TimeValue(String) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回一个 Date 值，该值包含以字符串表示的时间信息，其日期信息设置为元年 1 月 1 日。

public:
 static DateTime TimeValue(System::String ^ StringTime);

public static DateTime TimeValue (string StringTime);

static member TimeValue : string -> DateTime

Public Function TimeValue (StringTime As String) As DateTime

必需。字符串表达式，表示 1 年 1 月 1 日 00:00:00 到 9999 年 12 月 31 日 23:59:59 之间的一个日期/时间值。

一个 Date 值，该值包含以字符串表示的时间信息，其日期信息设置为元年 1 月 1 日。

StringTime 包含无效的日期信息。

以下示例使用 TimeValue 函数将字符串转换为时间。还可以使用日期文本直接将时间分配给 Date 变量。

Dim thisTime As Date
thisTime = TimeValue("4:35:17 PM")

可以使用 12 小时制或 24 小时制输入有效时间。例如， "2:24 P.M." 和 "14:24" 都是有效的 StringTime 参数。

StringTime如果参数包含日期信息，TimeValue则不会将其包含在返回的值中。但是，如果 StringTime 包含无效的日期信息，例如“1 月 32 日”，则会发生错误 InvalidCastException 。