Fungsi VariantTimeToDosDateTime (oleauto.h)

Mengonversi representasi varian tanggal dan waktu menjadi nilai tanggal dan waktu MS-DOS.

Sintaks

INT VariantTimeToDosDateTime(
  [in]  DOUBLE vtime,
  [out] USHORT *pwDosDate,
  [out] USHORT *pwDosTime
);

Parameter

[in] vtime

Waktu varian untuk mengonversi.

[out] pwDosDate

Menerima tanggal MS-DOS yang dikonversi.

[out] pwDosTime

Menerima waktu MS-DOS yang dikonversi

Nilai kembali

Fungsi mengembalikan TRUE pada keberhasilan dan FALSE jika tidak.

Keterangan

Waktu varian disimpan sebagai nilai riil 8-byte (ganda), mewakili tanggal antara 1 Januari 100 dan 31 Desember 9999, inklusif. Nilai 2,0 menunjukkan 1 Januari 1900; 3.0 mewakili 2 Januari 1900, dan sebagainya. Menambahkan 1 ke nilai akan menambah tanggal menurut hari. Bagian pecahan dari nilai mewakili waktu dalam sehari. Oleh karena itu, 2,5 mewakili siang pada 1 Januari 1900; 3.25 mewakili 6:00 A.M. pada 2 Januari 1900, dan sebagainya. Angka negatif menunjukkan tanggal sebelum 30 Desember 1899.

Untuk deskripsi format tanggal dan waktu MS-DOS, lihat DosDateTimeToVariantTime.

Fungsi VariantTimeToDosDateTime akan menerima tanggal yang tidak valid dan mencoba memperbaikinya saat menyelesaikan ke waktu VARIAN. Misalnya, tanggal yang tidak valid seperti 29/2/2001 akan diselesaikan menjadi 3/1/2001. Hanya hari yang diperbaiki, sehingga nilai bulan yang tidak valid mengakibatkan kesalahan dikembalikan. Hari diperiksa menjadi antara 1 dan 31. Hari dan hari negatif yang lebih besar dari 31 menghasilkan kesalahan. Hari kurang dari 31 tetapi lebih besar dari hari maksimum dalam bulan itu memiliki hari yang dipromosikan ke hari yang sesuai pada bulan berikutnya. Hari yang sama dengan nol diselesaikan sebagai hari terakhir bulan sebelumnya. Misalnya, tanggal yang tidak valid seperti 2/0/2001 akan diselesaikan menjadi 31/1/2001.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	oleauto.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll