Функция SystemTimeToTzSpecificLocalTime (timezoneapi.h)
Преобразует время в формате 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.
Комментарии
Функция SystemTimeToTzSpecificLocalTime учитывает, действует ли летнее время (DST) для местного времени, в которое должно быть преобразовано системное время.
Функция SystemTimeToTzSpecificLocalTime может неправильно вычислить местное время при следующих условиях:
- Часовой пояс использует другое смещение в формате UTC для старого и нового лет.
- Время в формате UTC для преобразования и вычисляемое местное время находятся в разных годах.
Примеры
Пример см. в разделе Получение времени Last-Write.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | timezoneapi.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |