TzSpecificLocalTimeToSystemTime function

Converts a local time to a time in Coordinated Universal Time (UTC).

Syntax

BOOL TzSpecificLocalTimeToSystemTime(
  const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  const SYSTEMTIME            *lpLocalTime,
  LPSYSTEMTIME                lpUniversalTime
);

Parameters

lpTimeZoneInformation

A pointer to a TIME_ZONE_INFORMATION structure that specifies the time zone for the time specified in lpLocalTime.

If lpTimeZoneInformation is NULL, the function uses the currently active time zone.

lpLocalTime

A pointer to a SYSTEMTIME structure that specifies the local time to be converted. The function converts this time to the corresponding UTC time.

lpUniversalTime

A pointer to a SYSTEMTIME structure that receives the UTC time.

Return Value

If the function succeeds, the return value is nonzero, and the function sets the members of the SYSTEMTIME structure pointed to by lpUniversalTime to the appropriate values.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

TzSpecificLocalTimeToSystemTime takes into account whether daylight saving time (DST) is in effect for the local time to be converted.

Requirements

   
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header timezoneapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

GetSystemTime

GetTimeZoneInformation

Local Time

SYSTEMTIME

SystemTimeToTzSpecificLocalTime

TIME_ZONE_INFORMATION

Time Functions