Método SWbemDateTime.GetVarDate
El método GetVarDate del objeto SWbemDateTime convierte un valor de fecha y hora en el formato DATETIME CIM al formato VT_DATE.
El formato VT_DATE es un valor DATETIME de variante de automatización que usan Visual Basic y ActiveX.
Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.
Sintaxis
vdate = .GetVarDate( _
[ ByVal bIsLocal ] _
)
Parámetros
-
bIsLocal [in, opcional]
-
Indica si el valor devuelto se interpreta como hora local. La propiedad Hora universal coordinada (UTC) contiene la hora local convertida en el desplazamiento UTC correcto. Si el valor es FALSE, el valor se interpreta como UTC con un desplazamiento cero (0).
Valor devuelto
Valor de fecha y hora en el formato VT_DATE.
Comentarios
Los valores VT_DATE y FILETIME no pueden contener campos comodín.
Se produce un error en el método GetVarDate (wbemErrFailed) si alguna de las siguientes propiedades es FALSE:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
Si la devolución de SetVarDate es correcta, todas estas propiedades se establecen en TRUE.
Después de una llamada correcta a SetVarDate, el valor DATETIME siempre se interpreta como un valor DATETIME absoluto en lugar de un intervalo y IsInterval se establece en FALSE.
Si IsInterval se establece en TRUE, una llamada a GetVarDate genera el error wbemErrFailed.
Se produce cierta pérdida de precisión cuando se llama a GetVarDate, porque los valores datetime tienen una resolución de microsegundos (s) y los valores VT_DATE tienen una resolución de 500 milisegundos.
Ejemplos
Para ver ejemplos de uso del objeto SWbemDateTime para convertir valores DATETIME CIM a y desde el formato FILETIME o VT_DATE, consulte Tareas de WMI: Fechas y horas. Para obtener una descripción del formato DATETIME de CIM, vea Formato de fecha y hora.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |