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

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

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

Синтаксис

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

Параметры

[in, optional] lpTimeZoneInformation

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

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

[in] lpLocalTime

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

[out] lpUniversalTime

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

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

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

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

Замечания

TzSpecificLocalTimeToSystemTimeTime учитывает, действует ли летнее время (DST) для преобразования локального времени.

Это важно

Следующие локальные времена, близкие к переходу DST, могут быть неоднозначными или недопустимыми и могут привести к непредвиденному поведению (так как нет гарантированного "правильного" результата).

  • Во время перехода с летнего времени на стандартное время местные часы повторяются. Локальное время в повторяемом окне неоднозначно , так как оно происходит дважды, один раз в летнее время и один раз в стандартное время.
  • Во время перехода с стандартного времени на летнее время, местные часы прыгают вперед. Локальное время в пропущенном окне недопустимо , так как оно не имеет допустимого преобразования в формате UTC.

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

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows XP [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер Windows Server 2003 [классические приложения | Приложения UWP]
целевая платформа Виндоус
Header timezoneapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

См. также

GetSystemTime

GetTimeZoneInformation

Локальное время

SYSTEMTIME

SystemTimeToTzSpecificLocalTime

TIME_ZONE_INFORMATION

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

  • Last updated on