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_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時發生某些精確度遺失,因為 datetime 值有一毫秒 () 解析度, 而VT_DATE 值有 500 毫秒的解析度。
範例
如需使用 SWbemDateTime 物件將 CIM DATETIME 值轉換成 FILETIME 或 VT_DATE 格式的範例,請參閱 WMI 工作:日期和時間。 如需 CIM DATETIME 格式的描述,請參閱 日期和時間格式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
標頭 |
|
類型程式庫 |
|
DLL |
|
CLSID |
CLSID_SWbemDateTime |
IID |
IID_ISWbemDateTime |