Méthode SWbemDateTime. getVarDate,
La méthode getVarDate, de l’objet SWbemDateTime convertit une valeur de date et d’heure au format DateTime CIM au format de _ Date VT .
le format de _ DATE VT est une valeur DATETIME automation variant qui Visual Basic et ActiveX utiliser.
Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.
Syntaxe
vdate = .GetVarDate( _
[ ByVal bIsLocal ] _
)
Paramètres
-
bIsLocal [ dans, facultatif]
-
Indique si la valeur retournée est interprétée comme heure locale. La propriété temps universel coordonné (UTC, Universal Time Coordinated) contient l’heure locale convertie en décalage UTC correct. Si la valeur est false, la valeur est interprétée comme étant UTC avec un décalage de zéro (0).
Valeur retournée
Valeur de date et d’heure au format de _ Date VT .
Remarques
VT _ Les valeurs de 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 a la valeur false:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
En cas de retour réussi de SetVarDate, toutes ces propriétés ont la valeur 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, provoque l’erreur wbemErrFailed .
Une perte de précision se produit lorsque vous appelez getVarDate,, car les valeurs DateTime ont une résolution d’une microseconde (s), et les valeurs de _ DATE VT ont une résolution de 500 millisecondes.
Exemples
Pour obtenir des exemples d’utilisation de l’objet SWbemDateTime pour convertir des valeurs DateTime CIM vers et à partir du format de _ Date fileTime ou VT, consultez tâches WMI : dates et heures. Pour obtenir une description du format DateTime CIM, consultez format de date et d’heure.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID _ SWbemDateTime |
| IID |
IID _ ISWbemDateTime |