Метод SWbemDateTime.GetVarDate
Метод GetVarDate объекта SWbemDateTime преобразует значение даты и времени в формате CIM DATETIME в формат VT_DATE .
Формат VT_DATE — это значение DATETIME варианта автоматизации, используемое Visual Basic и ActiveX.
Описание этого синтаксиса см. в разделе Соглашения о документах для API сценариев.
Синтаксис
vdate = .GetVarDate( _
[ ByVal bIsLocal ] _
)
Параметры
-
bIsLocal [in, optional]
-
Указывает, интерпретируется ли возвращаемое значение как местное время. Свойство UTC содержит местное время, преобразованное в правильное смещение в формате UTC. Если значение равно FALSE, значение интерпретируется как UTC со смещением нуля (0).
Возвращаемое значение
Значение даты и времени в формате VT_DATE .
Комментарии
значения VT_DATE и FILETIME не могут содержать поля с подстановочными знаками.
Метод GetVarDate завершается ошибкой (wbemErrFailed), если одно из следующих свойств имеет значение FALSE:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
При успешном возвращении из SetVarDate всем этим свойствам присваивается значение TRUE.
После успешного вызова SetVarDate значение DATETIME всегда интерпретируется как абсолютное значение DATETIME , а не интервал, а isInterval имеет значение FALSE.
Если параметр IsInterval имеет значение TRUE, вызов GetVarDate приводит к ошибке wbemErrFailed .
Некоторая потеря точности происходит при вызове GetVarDate, так как значения datetime имеют разрешение в один микросекунд (s), а VT_DATE значения — разрешение 500 миллисекунд.
Примеры
Примеры использования объекта SWbemDateTime для преобразования значений CIM DATETIME в формат FILETIME или VT_DATE и из нее см. в разделе Задачи WMI: даты и время. Описание формата CIM DATETIME см. в разделе Формат даты и времени.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Заголовок |
|
| Библиотека типов |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |