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

  • Статья

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

Синтаксис

BOOL GetTimeZoneInformationForYear(
  [in]           USHORT                         wYear,
  [in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
  [out]          LPTIME_ZONE_INFORMATION        ptzi
);

Параметры

[in] wYear

Год, в течение которого необходимо получить параметры часового пояса. Параметр wYear должен быть значением местного времени.

[in, optional] pdtzi

Указатель на структуру DYNAMIC_TIME_ZONE_INFORMATION , указывающую часовой пояс. Чтобы заполнить этот параметр, вызовите EnumDynamicTimeZoneInformation с индексом нужного часового пояса. Если этот параметр имеет значение NULL, используется текущий часовой пояс.

[out] ptzi

Указатель на структуру TIME_ZONE_INFORMATION , получающую параметры часового пояса.

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

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

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

Комментарии

Предполагается, что параметр wYear является значением локального времени. Если местное время близко к переходу между старым годом и новым годом (00:00:00 1 января), передача года UTC функции GetTimeZoneInformationForYear может привести к тому, что функция вернет параметры часового пояса для неправильного года.

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

Требования

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

См. также

DYNAMIC_TIME_ZONE_INFORMATION

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

TIME_ZONE_INFORMATION

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