SWbemDateTime.GetVarDate メソッド
SWbemDateTime オブジェクトの GetVarDate メソッドは、CIM の DATETIME 形式の日時の値を VT_DATE 形式に変換します。
VT_DATE 形式は、Visual Basic と ActiveX で使われるオートメーション バリアント DATETIME の値です。
この構文の説明については、「スクリプト API のドキュメントの表記規則」を参照してください。
構文
vdate = .GetVarDate( _
[ ByVal bIsLocal ] _
)
パラメーター
-
bIsLocal [in、省略可能]
-
返された値がローカル時刻として解釈されるかどうかを示します。 協定世界時 (UTC) プロパティには、正しい UTC オフセットに変換されたローカル時刻が格納されます。 この値が FALSE の場合、値はオフセットがゼロ (0) の UTC として解釈されます。
戻り値
VT_DATE 形式の日付と時刻の値。
解説
VT_DATE 値と FILETIME 値にワイルドカード フィールドを含めることはできません。
次のいずれかのプロパティが FALSE の場合、GetVarDate メソッドは失敗します (wbemErrFailed)。
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
SetVarDate から正常に戻った場合、これらのプロパティはすべて TRUE に設定されます。
SetVarDate の呼び出しが成功すると、DATETIME の値は間隔ではなく絶対 DATETIME 値として常に解釈され、IsInterval は FALSE に設定されます。
IsInterval が TRUE に設定されている場合、GetVarDate を呼び出すと wbemErrFailed エラーになります。
datetime 値の最小単位は 1 マイクロ秒で、VT_DATE 値の最小単位は 500 ミリ秒であるため、GetVarDate を呼び出すと、精度が低下する場合があります。
例
SWbemDateTime オブジェクトを使って CIM の DATETIME 値と FILETIME または VT_DATE 形式との間で変換を行う例については、「WMI タスク: 日付と時刻」をご覧ください。 CIM DATETIME 形式の説明については、「日付と時刻の形式」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| Header |
|
| タイプ ライブラリ |
|
| [DLL] |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |