TzSpecificLocalTimeToSystemTime function (timezoneapi.h)

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

Syntax

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

Parameters

[in, optional] 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.

[in] 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.

[out] 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

See also

GetSystemTime

GetTimeZoneInformation

Local Time

SYSTEMTIME

SystemTimeToTzSpecificLocalTime

TIME_ZONE_INFORMATION

Time Functions