Export (0) Print
Expand All

TzSpecificLocalTimeToSystemTime function

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

Syntax


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.

Windows Phone 8: This API is supported.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows XP [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 [desktop apps | Windows Store apps]

Header

Winbase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

GetSystemTime
GetTimeZoneInformation
Local Time
SYSTEMTIME
SystemTimeToTzSpecificLocalTime
Time Functions
TIME_ZONE_INFORMATION

 

 

Community Additions

ADD
Show:
© 2014 Microsoft