SWbemDateTime.GetVarDate 方法

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

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

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

语法

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

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

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

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

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

从 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 格式的说明，请参阅日期和时间格式。