Функция GetTimeZoneInformation (timezoneapi.h)

Статья
08/26/2023

Извлекает текущие параметры часового пояса. Эти параметры управляют переводами между универсальным координированным временем (UTC) и местным временем.

Для поддержки границ летнего времени, изменяющихся из года в год, используйте функцию GetDynamicTimeZoneInformation или GetTimeZoneInformationForYear .

Синтаксис

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

Параметры

[out] lpTimeZoneInformation

Указатель на структуру TIME_ZONE_INFORMATION для получения текущих параметров.

Возвращаемое значение

Если функция выполняется успешно, она возвращает одно из следующих значений.

Возвращаемый код или значение	Описание
TIME_ZONE_ID_UNKNOWN 0	Летнее время не используется в текущем часовом поясе, так как даты перехода отсутствуют или автоматическая настройка летнего времени отключена.
TIME_ZONE_ID_STANDARD 1	Система работает в диапазоне, охватываемом элементом StandardDateструктуры TIME_ZONE_INFORMATION .
TIME_ZONE_ID_DAYLIGHT 2	Система работает в диапазоне, охватываемом элементом DaylightDateструктуры TIME_ZONE_INFORMATION .

Если функция завершается сбоем по другим причинам, например по причине нехватки памяти, она возвращает TIME_ZONE_ID_INVALID. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Элементы StandardName и DaylightName результирующей структуры TIME_ZONE_INFORMATION локализованы в соответствии с текущим языком пользовательского интерфейса пользователя по умолчанию.

Примеры

Пример см. в разделе SetTimeZoneInformation.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	timezoneapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll