SWbemDateTime.GetVarDate 方法

SWbemDateTime 对象的 GetVarDate 方法将 CIM DATETIME 格式的日期和时间值转换为 VT_DATE 格式。

VT_DATE 格式是 Visual Basic 和 ActiveX 使用的自动化变体 DATETIME 值。

有关此语法的说明，请参阅脚本 API 的文档约定。

语法

vdate = .GetVarDate( _
  [ ByVal bIsLocal ] _
)

parameters

bIsLocaL [in, optional]

指示返回值是否被解释为本地时间。 协调世界时 (UTC) 属性包含转换为正确的 UTC 偏移量的本地时间。 如果值为 FALSE，则该值被解释为具有零 (0) 偏移量的 UTC。

返回值

采用 VT_DATE 格式的日期和时间值。

备注

VT_DATE 和 FILETIME 值不能包含通配符字段。

如果以下任何属性为 FALSE，则 GetVarDate 方法失败 (wbemErrFailed)：

• YearSpecified
• MonthSpecified
• DaySpecified
• HoursSpecified
• MinutesSpecified
• SecondsSpecified
• MicrosecondsSpecified
• UTCSpecified

从 SetVarDate 成功返回后，所有这些属性都设置为 TRUE。

成功调用 SetVarDate 后，DATETIME 值始终被解释为绝对 DATETIME 值而不是间隔，IsInterval 设置为 FALSE。

如果 IsInterval 设置为 TRUE，则调用 GetVarDate 会导致 wbemErrFailed 错误。

调用 GetVarDate 时，会出现一些精度损失，因为日期时间值的精度为 1 微秒，VT_DATE 值的精度为 500 毫秒。

示例

有关使用 SWbemDateTime 对象将 CIM DATETIME 值与 FILETIME 格式或 VT_DATE 格式相互转换的示例，请参阅 WMI 任务：日期和时间。 有关 CIM DATETIME 格式的说明，请参阅日期和时间格式。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	Wbemdisp.h
类型库	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemDateTime
IID	IID_ISWbemDateTime

另请参阅

SWbemDateTime.GetFileTime

SWbemDateTime

DATETIME