Функция GetTimeZoneInformation извлекает текущие параметры часового пояса. Эти параметры управляют преобразованиями между Универсальным глобальным временем (UTC) и местным временем.
DWORD GetTimeZoneInformation( LPTIME_ZONE_INFORMATION lpTimeZoneInformation ); |
[out] Указатель на структуру TIME_ZONE_INFORMATION, которая получает текущие параметры часового пояса.
Если функция завершается успешно, возвращаемое значение - одно из ниже перечисленных значений.
Возвращаемый код/значение |
Описание |
|---|---|
| TIME_ZONE_ID_UNKNOWN 0 |
Летнее время не используется в текущем часовом поясе, поэтому нет никаких переходных дат или автоматическая надстройка на летнее время отключена.
Система не может определить текущий часовой пояс. Эта ошибка также возвращается, если Вы вызываете функцию SetTimeZoneInformation и даёте значения смещения, но не меняете даты. |
| TIME_ZONE_ID_STANDARD 1 |
Система оперирует в диапазоне, охваченном членом StandardDate структуры
TIME_ZONE_INFORMATION.
Windows Me/98/95: Это значение возвращается, если летнее время не используется в текущем часовом поясе, потому что нет переходных дат. |
| TIME_ZONE_ID_DAYLIGHT 2 |
Система оперирует в диапазоне, охваченном членом DaylightDate структуры TIME_ZONE_INFORMATION. |
Если функция завершается ошибкой, возвращаемое значение - TIME_ZONE_ID_INVALID. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Все преобразования между UTC и местным временем основаны на нижеследующей формуле:
|
Смещение - это различие, в минутах, между временем универсального глобального времени (UTC) и местным временем.
Пример смотри в описании функции SetTimeZoneInformation.
Обзор Время (операционной системы), Функции, используемые для времени, GetDynamicTimeZoneInformation, GetTimeZoneInformationForYear, SetTimeZoneInformation, TIME_ZONE_INFORMATION
| Размещение и совместимость GetTimeZoneInformation | ||
| К | Windows Vista | Да |
| л | Windows XP | Да |
| и | Windows 2000 Professional | Да |
| е | Windows NT Workstation | Да |
| н | Windows Me | Да |
| т | Windows 98 | Да |
| Windows 95 | Да | |
| С | Windows Server 2008 | Да |
| е | Windows Server 2003 | Да |
| р | Windows 2000 Server | Да |
| в | Windows NT Server | Да |
| е | ||
| р | ||
| Используемая библиотека | Kernel32.lib | |
| Используемая DLL | kernel32.dll | |
| Заголовочный файл | ||
| - объявлено в | Winbase.h | |
| - включено в | Windows.h | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |