GetTimeZoneInformationForYear 函数 (timezoneapi.h)
检索指定年份和时区的时区设置。 这些设置控制协调世界时 (UTC) 和本地时间之间的转换。
语法
BOOL GetTimeZoneInformationForYear(
[in] USHORT wYear,
[in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
[out] LPTIME_ZONE_INFORMATION ptzi
);
参数
[in] wYear
要检索时区设置的年份。 wYear 参数必须是本地时间值。
[in, optional] pdtzi
指向指定时区 的DYNAMIC_TIME_ZONE_INFORMATION 结构的指针。 若要填充此参数，请使用所需时区的索引调用 EnumDynamicTimeZoneInformation 。 如果此参数为 NULL，则使用当前时区。
[out] ptzi
指向接收时区设置 的TIME_ZONE_INFORMATION 结构的指针。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
注解
假定 wYear 参数为本地时间值。 如果本地时间接近) 年 1 月 1 日 00：00：00 (旧年和新年之间的转换，则将 UTC 年份传递给 GetTimeZoneInformationForYear 函数可能会导致函数返回错误年份的时区设置。
生成的TIME_ZONE_INFORMATION结构的 StandardName 和 DaylightName 成员根据当前用户默认 UI 语言进行本地化。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista SP1 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | timezoneapi.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |