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

Преобразует указанное локальное время с параметрами динамического летнего времени (DST) в соответствующее время в формате UTC.

Синтаксис

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

Параметры

[in, optional] lpTimeZoneInformation

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

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

[in] lpLocalTime

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

[out] lpUniversalTime

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

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

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

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

Замечания

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

Это важно

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

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

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

Требования

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