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 形式の説明については、「日付と時刻の形式」を参照してください。

要件

関連項目

SWbemDateTime.GetFileTime

SWbemDateTime

DATETIME