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

另请参阅

DYNAMIC_TIME_ZONE_INFORMATION

本地时间

TIME_ZONE_INFORMATION

时间函数