SystemTimeToTzSpecificLocalTime
The SystemTimeToTzSpecificLocalTime
function converts a Coordinated Universal Time (UTC) to a specified time zone s
corresponding local time.
BOOL SystemTimeToTzSpecificLocalTime(
|
LPTIME_ZONE_INFORMATION lpTimeZoneInformation, |
// pointer to time
zone of interest |
|
LPSYSTEMTIME lpUniversalTime, |
// pointer to
universal time of interest |
|
LPSYSTEMTIME lpLocalTime |
// pointer to structure to receive local time |
|
); |
|
Parameters
lpTimeZoneInformation
Pointer to a TIME_ZONE_INFORMATION structure that specifies
the time zone of interest.
If lpTimeZoneInformation
is NULL, the function uses the currently active time zone.
lpUniversalTime
Pointer to a SYSTEMTIME structure that specifies a
UTC. The function converts this universal time to the specified time zone s
corresponding local time.
lpLocalTime
Pointer to a SYSTEMTIME
structure that receives the local time information.
Return Values
If the
function succeeds, the return value is nonzero, and the function sets the
members of the SYSTEMTIME
structure pointed to by lpLocalTime to the appropriate local time
values.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The SystemTimeToTzSpecificLocalTime
function works in Windows NT. If called in Windows 95, the function fails, and
returns FALSE.
See Also