TzSpecificLocalTimeToSystemTime 函数 (timezoneapi.h)
将本地时间转换为协调世界时 (UTC) 的时间。
语法
BOOL TzSpecificLocalTimeToSystemTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpLocalTime,
[out] LPSYSTEMTIME lpUniversalTime
);
参数
[in, optional] lpTimeZoneInformation
指向 TIME_ZONE_INFORMATION 结构的指针,该结构指定 lpLocalTime 中指定的时间的时区。
如果 lpTimeZoneInformation 为 NULL,则该函数使用当前活动时区。
[in] lpLocalTime
指向 SYSTEMTIME 结构的指针,该结构指定要转换的本地时间。 函数将此时间转换为相应的 UTC 时间。
[out] lpUniversalTime
指向接收 UTC 时间的 SYSTEMTIME 结构的指针。
返回值
如果函数成功,则返回值为非零值,并且该函数将 lpUniversalTime 指向的 SYSTEMTIME 结构的成员设置为适当的值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
TzSpecificLocalTimeToSystemTime 考虑夏令时 (DST) 是否对要转换的本地时间有效。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | timezoneapi.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |