Функция GetTimeZoneInformationForYear

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

Синтаксис

BOOL WINAPI GetTimeZoneInformationForYear(
  __in      USHORT wYear,
  __in_opt  PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
  __out     LPTIME_ZONE_INFORMATION ptzi
);

Параметры

wYear

Это год, для которого должны извлечься параметры настройки часового пояса. Параметр 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 Нет
Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz