Справочник по технологии COM
Страница 80. VariantTimeToSystemTime
Страница 80 из 111
 

VariantTimeToSystemTime

Преобразует время из формата варианта в системный формат. 

INT VariantTimeToSystemTime
( 
double vtime, 
LPSYSTEMTIME IpSystemTime
);

Параметры:
vtime
Время в формате варианта.
IpSystemTime
Указатель, по которому помещается результат преобразования.

Возвращаемое значение:
Возвращается одно из следующих значений:

Результат Значение
True Успех.
False Ошибка.

Комментарии:
Время в формате варианта хранится как восьмибайтовое вещественное число (double), представляющее дату в промежутке между 1 января 1753 года и 31 декабря 2078 года включительно. Значение 2.0 соответствует 1 января 1900 года, 3.0 — 2 января 1900 года и т. д. Прибавление единицы увеличивает значение на 1 день. Дробная часть значения представляет время дня. Таким образом, 2.5 соответствует полудню 1 января 1900 года, 3.25 — 6 утра 2 января 1900 года и т. д. Отрицательные числа соответствуют датам, предшествующим 30 декабря 1899 года. Использование структуры SYSTEMTIME дает следующие преимущества:
Она покрывает весь диапазон дат/времен. Формат же MS-DOS позволяет представлять даты только между 1.1.1980 и 31.12.2107.
Элементы даты и времени доступны непосредственно и не требуют декодирования битов.
Функции поддержки национальных языков для форматирования даты и времени GetDateFormat и GetTimeFormat используют параметр SYSTEMTIME.
Это стандартный формат представления даты и времени в Win32, поддерживаемый Windows NT и Windows 95. 
 
Следующая статья »