Извлекает параметры настройки часового пояса в течение заданного года и часового пояса. Эти параметры настройки управляют преобразованиями между Универсальным глобальным временем (UTC) и местным временем.
BOOL WINAPI GetTimeZoneInformationForYear( __in USHORT wYear, __in_opt PDYNAMIC_TIME_ZONE_INFORMATION pdtzi, __out LPTIME_ZONE_INFORMATION ptzi ); |
Это год, для которого должны извлечься параметры настройки часового пояса. Параметр wYear должен быть значением местного времени.
pdtziУказатель на структуру DYNAMIC_TIME_ZONE_INFORMATION, которая определяет часовой пояс. Если этот параметр - NULL, текущий часовой пояс используется.
ptziУказатель на структуру TIME_ZONE_INFORMATION, которая получает параметры настройки часового пояса.
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Предполагается, что параметр wYear будет значением местного времени. Если местное время близко к переходному состоянию между старым и новым годом (00:00:00 1 января), передавая год универсального глобального времени (UTC) в функцию GetTimeZoneInformationForYear можно заставить функцию возвратить параметры настройки часового пояса для ошибочного года.
Обзор Время (операционной системы), Функции, используемые для времени, DYNAMIC_TIME_ZONE_INFORMATION, TIME_ZONE_INFORMATION
Размещение и совместимость GetTimeZoneInformationForYear | ||
К | Windows Vista | Да SP1 |
л | 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 | Нет | |
Замечания по платформе | Не имеется |