The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

TzSpecificLocalTimeToSystemTime function

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

Syntax

C++


BOOL WINAPI TzSpecificLocalTimeToSystemTime(
  _In_opt_ LPTIME_ZONE_INFORMATION lpTimeZoneInformation,
  _In_     LPSYSTEMTIME            lpLocalTime,
  _Out_    LPSYSTEMTIME            lpUniversalTime
);

Parameters

lpTimeZoneInformation [in, optional]

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

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

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 \| Windows Store apps]
Minimum supported server	Windows Server 2003 [desktop apps \| Windows Store apps]
Minimum supported phone	Windows Phone 8
Header	Winbase.h (include Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll