SWbemDateTime.GetVarDate 方法

SWbemDateTime物件的GetVarDate方法會將 CIM DATETIME格式中的日期和時間值轉換為VT_DATE格式。

VT_DATE格式是 Visual Basic 和 ActiveX 使用的自動化 VARIANT DATETIME值。

如需此語法的說明,請參閱 腳本 API 的檔慣例

語法

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

參數

bIsLocal [in, optional]

指出傳回的值是否解譯為當地時間。 國際標準時間 (UTC) 屬性包含轉換成正確 UTC 位移的當地時間。 如果值為 FALSE,則會將值解譯為 UTC,且零 (0) 位移。

傳回值

VT_DATE 格式的 日期和時間值。

備註

VT_DATEFILETIME 值不能包含萬用字元欄位。

如果下列任何屬性為FALSEGetVarDate方法會失敗 (wbemErrFailed) :

SetVarDate成功傳回時,所有這些屬性都會設定為 TRUE

成功呼叫 SetVarDate之後, DATETIME 值一律會解譯為絕對 DATETIME 值,而不是間隔, 而 IsInterval 會設定為 FALSE

如果 IsInterval 設定為 TRUE,則 對 GetVarDate 的呼叫會導致 wbemErrFailed 錯誤。

呼叫 GetVarDate時發生某些精確度遺失,因為 datetime 值有一毫秒 () 解析度, 而VT_DATE 值有 500 毫秒的解析度。

範例

如需使用 SWbemDateTime 物件將 CIM DATETIME 值轉換成 FILETIMEVT_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