Metode SWbemDateTime.GetVarDate

Metode GetVarDate objek SWbemDateTime mengonversi nilai tanggal dan waktu dalam format DATETIME CIM ke format VT_DATE .

Format VT_DATE adalah nilai DATETIME varian otomatisasi yang digunakan Visual Basic dan ActiveX.

Untuk penjelasan tentang sintaks ini, lihat Konvensi Dokumen untuk Scripting API.

Sintaks

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

Parameter

bIsLocal [in, opsional]

Menunjukkan apakah nilai yang dikembalikan ditafsirkan sebagai waktu lokal. Properti Waktu Universal Terkoordinasi (UTC) berisi waktu lokal yang dikonversi ke offset UTC yang benar. Jika nilainya FALSE, maka nilai ditafsirkan sebagai UTC dengan offset nol (0).

Nilai kembali

Nilai tanggal dan waktu dalam format VT_DATE .

Keterangan

VT_DATE dan nilai FILETIME tidak boleh berisi bidang kartubebas.

Metode GetVarDate gagal (wbemErrFailed) jika salah satu properti berikut adalah FALSE:

• TahunDispesifikasikan
• MonthSpecified
• DaySpecified
• Jam Ditentukan
• MenitDispesifikasikan
• SecondsSpecified
• MicrosecondsSpecified
• UTCSpecified

Saat pengembalian berhasil dari SetVarDate, semua properti ini diatur ke TRUE.

Setelah panggilan berhasil ke SetVarDate, nilai DATETIME selalu ditafsirkan sebagai nilai DATETIME absolut, bukan interval, dan IsInterval diatur ke FALSE.

Jika IsInterval diatur ke TRUE, panggilan ke GetVarDate menghasilkan kesalahan wbemErrFailed .

Beberapa hilangnya presisi terjadi ketika Anda memanggil GetVarDate, karena nilai tanggalwaktu memiliki satu resolusi mikro detik ( s), dan nilai VT_DATE memiliki resolusi 500 milidetik.

Contoh

Untuk contoh penggunaan objek SWbemDateTime untuk mengonversi nilai CIM DATETIME ke dan dari format FILETIME atau VT_DATE , lihat Tugas WMI: Tanggal dan Waktu. Untuk deskripsi format DATETIME CIM, lihat Format Tanggal dan Waktu.

Persyaratan

Lihat juga

SWbemDateTime.GetFileTime

SWbemDateTime

DATETIME