Méthode SWbemDateTime.GetVarDate

La méthode GetVarDate de l’objet SWbemDateTime convertit une valeur de date et d’heure au format CIM DATETIME au format VT_DATE.

Le format VT_DATE est une valeur DATETIME de variante Automation utilisée par Visual Basic et ActiveX.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.

Syntaxe

vdate = .GetVarDate( _
  [ ByVal bIsLocal ] _
)

Paramètres

bIsLocal [entier, facultatif]

Indique si la valeur retournée est interprétée comme une heure locale. La propriété UTC (Temps universel coordonné) contient l’heure locale convertie en décalage UTC correct. Si la valeur est FALSE, la valeur est interprétée comme UTC avec un décalage égal à zéro (0).

Valeur retournée

Valeur de date et d’heure au format VT_DATE.

Notes

Les valeurs VT_DATE et FILETIME ne peuvent pas contenir de champs génériques.

La méthode GetVarDate échoue (wbemErrFailed) si l’une des propriétés suivantes est FALSE :

• YearSpecified
• MonthSpecified
• DaySpecified
• HoursSpecified
• MinutesSpecified
• SecondsSpecified
• MicrosecondsSpecified
• UTCSpecified

En cas de retour réussi de SetVarDate, toutes ces propriétés sont définies sur TRUE.

Après un appel réussi à SetVarDate, la valeur DATETIME est toujours interprétée comme une valeur DATETIME absolue au lieu d’un intervalle et isInterval est défini sur FALSE.

Si IsInterval a la valeur TRUE, un appel à GetVarDate génère l’erreur wbemErrFailed.

Une perte de précision se produit quand vous appelez GetVarDate, car les valeurs datetime ont une résolution d’une microseconde (s), tandis que les valeurs VT_DATE ont une résolution de 500 millisecondes.

Exemples

Pour obtenir des exemples d’utilisation de l’objet SWbemDateTime pour convertir des valeurs CIM DATETIME au format FILETIME ou VT_DATE, et inversement, consultez Tâches WMI : dates et heures. Pour obtenir une description du format CIM DATETIME, consultez Format de date et d’heure.

Spécifications

Voir aussi

SWbemDateTime.GetFileTime

SWbemDateTime

DATETIME