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	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemDateTime
IID	IID_ISWbemDateTime

Confira também

SWbemDateTime.GetFileTime

SWbemDateTime

DATETIME