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

Статья
08/26/2023

Преобразует время в формате UTC в соответствующее местное время указанного часового пояса.

Синтаксис

BOOL SystemTimeToTzSpecificLocalTime(
  [in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  [in]           const SYSTEMTIME            *lpUniversalTime,
  [out]          LPSYSTEMTIME                lpLocalTime
);

Параметры

[in, optional] lpTimeZoneInformation

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

Если lpTimeZone имеет значение NULL, функция использует текущий активный часовой пояс.

[in] lpUniversalTime

Указатель на структуру SYSTEMTIME , указывающую время в формате UTC для преобразования. Функция преобразует это универсальное время в соответствующее местное время указанного часового пояса.

[out] lpLocalTime

Указатель на структуру SYSTEMTIME , которая получает местное время.

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

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

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

Часовой пояс использует другое смещение в формате UTC для старого и нового лет.
Время в формате UTC для преобразования и вычисляемое местное время находятся в разных годах.

Примеры

Пример см. в разделе Получение времени Last-Write.

Требования

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