Поделиться через


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

Извлекает текущие параметры часового пояса. Эти параметры управляют переводами между универсальным координированным временем (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.

Комментарии

Все переводы между временем в формате 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

См. также

GetDynamicTimeZoneInformation

GetTimeZoneInformationForYear

Местное время

SetTimeZoneInformation

TIME_ZONE_INFORMATION

Функции времени