Método SWbemDateTime.GetVarDate
O método GetVarDate do objeto SWbemDateTime converte um valor de data e hora no formato DATETIME do CIM para o formato VT_DATE.
O formato VT_DATE é um valor de DATETIME da variante de automação que o Visual Basic e o ActiveX usam.
Para ver uma explicação dessa sintaxe, consulte Convenções de documentação para a API de Script.
Sintaxe
vdate = .GetVarDate( _
[ ByVal bIsLocal ] _
)
Parâmetros
-
bIsLocal [entrada, opcional]
-
Indica se o valor retornado é interpretado como hora local. A propriedade UTC (Tempo Universal Coordenado) contém a hora local convertida no deslocamento UTC correto. Se o valor for FALSE, o valor será interpretado como UTC com um deslocamento zero (0).
Retornar valor
O valor de data e hora no formato VT_DATE.
Comentários
Os valores VT_DATE e FILETIME não podem conter campos curinga.
O método GetVarDate falhará (wbemErrFailed) se qualquer uma das seguintes propriedades for FALSE:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
No retorno bem-sucedido de SetVarDate, todas essas propriedades são definidas como TRUE.
Após uma chamada bem-sucedida para SetVarDate, o valor DATETIME é sempre interpretado como um valor DATETIME absoluto em vez de um intervalo e IsInterval é definido como FALSE.
Se IsInterval for definido como TRUE, uma chamada para GetVarDate resultará no erro wbemErrFailed.
Alguma perda de precisão ocorre ao chamar o GetVarDate, porque os valores de data e hora têm uma resolução de um microssegundo (s) e os valores VT_DATE têm uma resolução de 500 milissegundos.
Exemplos
Para obter exemplos de como usar o objeto SWbemDateTime para converter valores DATETIME do CIM e para o formato FILETIME ou VT_DATE, consulte Tarefas do WMI: datas e horas. Para obter uma descrição do formato DATETIME do CIM, consulte Formato de data e hora.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |