SystemTimeToTzSpecificLocalTime 函数 (timezoneapi.h)
将协调世界时 (UTC) 的时间转换为指定时区的相应本地时间。
语法
BOOL SystemTimeToTzSpecificLocalTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpUniversalTime,
[out] LPSYSTEMTIME lpLocalTime
);
参数
[in, optional] lpTimeZoneInformation
指向 TIME_ZONE_INFORMATION 结构的指针，该结构指定感兴趣的时区。
如果 lpTimeZone 为 NULL，则该函数使用当前活动时区。
[in] lpUniversalTime
指向 SYSTEMTIME 结构的指针，该结构指定要转换的 UTC 时间。 函数将此通用时间转换为指定时区的相应本地时间。
[out] lpLocalTime
指向接收本地时间的 SYSTEMTIME 结构的指针。
返回值
如果函数成功，则返回值为非零值，并且函数将 lpLocalTime 指向的 SYSTEMTIME 结构的成员设置为适当的本地时间值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
注解
SystemTimeToTzSpecificLocalTime 函数考虑夏令时 (DST) 是否在系统时间转换为的本地时间有效。
在以下情况下 ，SystemTimeToTzSpecificLocalTime 函数可能会错误地计算本地时间：
- 时区对新旧年份使用不同的 UTC 偏移量。
- 要转换的 UTC 时间和计算的本地时间以不同的年份表示。
示例
有关示例，请参阅 检索 Last-Write 时间。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | timezoneapi.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |