GetTimeZoneInformation 函数 (timezoneapi.h)
检索当前时区设置。 这些设置控制协调世界时 (UTC) 和本地时间之间的转换。
若要支持夏令时在每年之间变化的边界,请使用 GetDynamicTimeZoneInformation 或 GetTimeZoneInformationForYear 函数。
语法
DWORD GetTimeZoneInformation(
[out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);
参数
[out] lpTimeZoneInformation
指向 TIME_ZONE_INFORMATION 结构的指针,用于接收当前设置。
返回值
如果函数成功,则返回以下值之一。
返回代码/值 | 说明 |
---|---|
|
在当前时区中不使用夏令时,因为没有转换日期或禁用夏令时自动调整。 |
|
系统在 TIME_ZONE_INFORMATION 结构的 StandardDate 成员所涵盖的范围内运行。 |
|
系统在TIME_ZONE_INFORMATION结构的 DaylightDate 成员所涵盖的范围内运行。 |
如果函数因其他原因(例如内存不足错误)而失败,则返回TIME_ZONE_ID_INVALID。 要获得更多的错误信息,请调用 GetLastError。
注解
UTC 时间和本地时间之间的所有转换都基于以下公式:
UTC = 本地时间 + 偏差
偏差是 UTC 时间和本地时间之间的差异(以分钟为单位)。
生成的TIME_ZONE_INFORMATION结构的 StandardName 和 DaylightName 成员根据当前用户默认 UI 语言进行本地化。
示例
有关示例,请参阅 SetTimeZoneInformation。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | timezoneapi.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |