GetTimeZoneInformation 函数 (timezoneapi.h)

检索当前时区设置。这些设置控制协调世界时 (UTC) 和本地时间之间的转换。

若要支持夏令时在每年之间变化的边界，请使用 GetDynamicTimeZoneInformation 或 GetTimeZoneInformationForYear 函数。

语法

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

[out] lpTimeZoneInformation

指向 TIME_ZONE_INFORMATION 结构的指针，用于接收当前设置。

如果函数成功，则返回以下值之一。

返回代码/值	说明
TIME_ZONE_ID_UNKNOWN 0	在当前时区中不使用夏令时，因为没有转换日期或禁用夏令时自动调整。
TIME_ZONE_ID_STANDARD 1	系统在 TIME_ZONE_INFORMATION 结构的 StandardDate 成员所涵盖的范围内运行。
TIME_ZONE_ID_DAYLIGHT 2	系统在TIME_ZONE_INFORMATION结构的 DaylightDate 成员所涵盖的范围内运行。

如果函数因其他原因（例如内存不足错误）而失败，则返回TIME_ZONE_ID_INVALID。要获得更多的错误信息，请调用 GetLastError。

UTC 时间和本地时间之间的所有转换都基于以下公式：

UTC = 本地时间 + 偏差

偏差是 UTC 时间和本地时间之间的差异（以分钟为单位）。

生成的TIME_ZONE_INFORMATION结构的 StandardName 和 DaylightName 成员根据当前用户默认 UI 语言进行本地化。

有关示例，请参阅 SetTimeZoneInformation。