Функция DosDateTimeToVariantTime (oleauto.h)

Преобразует представление времени MS-DOS в представление даты и времени, хранящееся в варианте .

Синтаксис

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

Параметры

[in] wDosDate

Преобразуемая дата MS-DOS. Допустимый диапазон дат MS-DOS — с 1 января 1980 г. по 31 декабря 2099 г. включительно.

[in] wDosTime

Время преобразования MS-DOS.

[out] pvtime

Преобразованное время.

Возвращаемое значение

Функция возвращает значение TRUE при успешном выполнении и FALSE в противном случае.

Комментарии

MS-DOS записывает даты и время файлов в виде упакованных 16-разрядных значений. Дата MS-DOS имеет следующий формат.

Bits	Содержимое
0–4	День месяца (1–31).
5–8	Месяц (1 = январь, 2 = февраль и т. д.).
9–15	Смещение года по сравнению с 1980 (добавьте 1980, чтобы получить фактический год).

 

Время MS-DOS имеет следующий формат.

Bits	Содержимое
0–4	Секунда делится на 2.
5–10	Минута (0–59).
11–15	Час (0–23 в 24-часовом режиме).

 

Функция DosDateTimeToVariantTime принимает недопустимые даты и пытается исправить их при разрешении на время VARIANT. Например, недопустимая дата, например 29.02.2001, будет считаться 01.03.2001. Исправлены только дни, поэтому недопустимые значения месяца приводят к ошибке. Количество дней в диапазоне от 1 до 31. Отрицательные дни и дни больше 31 приводят к ошибке. День меньше 31, но больше, чем максимальный день в этом месяце, имеет день повышен до соответствующего дня следующего месяца. День, равный нулю, разрешается как последний день предыдущего месяца. Например, недопустимая дата, например 02.0.2001, будет считаться 31.01.2001.

Требования

Требование	Значение
Целевая платформа	Windows
Header	oleauto.h
Библиотека	OleAut32.lib
DLL	OleAut32.dll