Fungsi DosDateTimeToVariantTime (oleauto.h)

Mengonversi representasi waktu MS-DOS ke representasi tanggal dan waktu yang disimpan dalam varian.

Sintaks

INT DosDateTimeToVariantTime(
  [in]  USHORT wDosDate,
  [in]  USHORT wDosTime,
  [out] DOUBLE *pvtime
);

Parameter

[in] wDosDate

Tanggal MS-DOS untuk dikonversi. Rentang tanggal MS-DOS yang valid adalah 1 Januari 1980, hingga 31 Desember 2099, inklusif.

[in] wDosTime

Waktu MS-DOS untuk mengonversi.

[out] pvtime

Waktu yang dikonversi.

Nilai kembali

Fungsi mengembalikan TRUE pada keberhasilan dan FALSE jika tidak.

Keterangan

MS-DOS merekam tanggal dan waktu file sebagai nilai 16-bit yang dikemas. Tanggal MS-DOS memiliki format berikut.

Bit	Konten
0–4	Hari dalam sebulan (1–31).
5–8	Bulan (1 = Januari, 2 = Februari, dan sebagainya).
9–15	Offset tahun dari 1980 (tambahkan 1980 untuk mendapatkan tahun aktual).

 

Waktu MS-DOS memiliki format berikut.

Bit	Konten
0–4	Kedua dibagi 2.
5–10	Menit (0–59).
11–15	Jam (0– 23 pada jam 24 jam).

 

Fungsi DosDateTimeToVariantTime 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. Sehari 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