Функция GetTimeZoneInformation (timezoneapi.h)
Извлекает текущие параметры часового пояса. Эти параметры управляют переводами между универсальным координированным временем (UTC) и местным временем.
Для поддержки границ летнего времени, изменяющихся из года в год, используйте функцию GetDynamicTimeZoneInformation или GetTimeZoneInformationForYear .
Синтаксис
DWORD GetTimeZoneInformation(
[out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);
Параметры
[out] lpTimeZoneInformation
Указатель на структуру TIME_ZONE_INFORMATION для получения текущих параметров.
Возвращаемое значение
Если функция выполняется успешно, она возвращает одно из следующих значений.
| Возвращаемый код или значение | Описание |
|---|---|
|
Летнее время не используется в текущем часовом поясе, так как даты перехода отсутствуют или автоматическая настройка летнего времени отключена. |
|
Система работает в диапазоне, охватываемом элементом StandardDateструктуры TIME_ZONE_INFORMATION . |
|
Система работает в диапазоне, охватываемом элементом DaylightDateструктуры TIME_ZONE_INFORMATION . |
Если функция завершается сбоем по другим причинам, например по причине нехватки памяти, она возвращает TIME_ZONE_ID_INVALID. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Все переводы между временем в формате UTC и местным временем основаны на следующей формуле:
UTC = местное время + смещение
Смещение — это разница в минутах между временем в формате UTC и местным временем.
Элементы StandardName и DaylightName результирующей структуры TIME_ZONE_INFORMATION локализованы в соответствии с текущим языком пользовательского интерфейса пользователя по умолчанию.
Примеры
Пример см. в разделе SetTimeZoneInformation.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | timezoneapi.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |