Справочник по технологии COM
Страница 81. SystemTimeToVariantTime
|
|
Страница 81 из 111
SystemTimeToVariantTime Преобразует системный формат времени в формат варианта. INT SystemTimeToVariantTime
(
SYSTEMTIME IpSystemTime,
double *pvtime
);
Параметры:
IpSystemTime
Системное время.
pvtime
Возвращаемое значение времени в формате варианта. Возвращаемое значение:
Возвращается одно из следующих значений:
| Результат | Значение | | 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. |