C++ 将本地时间转换为特定时区的时间-C++-PHP中文网

c++oding="utf-8" ?>

C++20 中 std::chrono::zoned_time 与 std::format 可实现时区转换，但仅 libc++ 和 MSVC 19.35+ 支持；libstdc++ 仍缺失 time_zone；跨平台推荐 Howard Hinnant 的 date.h；Windows API 方案受限于夏令时历史和 IANA 名称映射；简单 time_t ± offset 不适用于 DST、历史变更及政治调整。

c++ 将本地时间转换为特定时区的时间

std::chrono + std::format 在 C++20 中直接转时区（需 libc++ 或 MSVC 19.35+）

标准库直到 C++20 才真正支持时区转换，但支持程度高度依赖实现。libc++（macOS / Linux clang）和较新 MSVC（19.35+）能用 std::chrono::zoned_time 和 std::format 做本地时间到目标时区的转换；GCC libstdc++（截至 13.x）仍不支持 std::chrono::time_zone，强行编译会报 ‘time_zone’ is not a member of ‘std::chrono’。

实操建议：

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

确认编译器和标准库：用 __cplusplus 和 __GLIBCXX__/_LIBCPP_VERSION 宏判断，或直接尝试包含后访问 std::chrono::current_zone()
若可用，先用 std::chrono::system_clock::now() 获取本地时间点（std::chrono::sys_time），再构造 std::chrono::zoned_time{"Asia/Shanghai", sys_tp}
输出格式推荐用 std::format("{:%Y-%m-%d %H:%M:%S %Z}", zt)，避免手动拼接；注意 %Z 输出缩写（如 CST），%z 输出偏移（如 +0800）

用 tzdb 数据库 + date.h（C++11/14/17 兼容方案）

Howard Hinnant 的 date.h 是目前最成熟的跨平台时区处理方案，它把 IANA 时区数据库打包进头文件，不依赖系统时区文件路径（如 /usr/share/zoneinfo），也绕开了 libstdc++ 的缺失问题。

实操建议：

下载 date.h 和 tz.h，确保 #include "tz.h" 前已调用 date::set_install("/path/to/zoneinfo")（若用默认内置数据可跳过）
本地时间通常指系统当前时区的时间，用 date::local_days{date::year_month_day{}} + 10h + 30min 构造本地时刻，再通过 date::zoned_seconds{"Europe/Berlin", local_tp} 转换
注意：date::local_days 是“本地日历日期”，不是 UTC；若你手头只有 time_t 或 struct tm*，先用 date::sys_days{date::floor(tp)} 归一化为系统时间点，再转时区

Windows 上用 GetTimeZoneInformation + SystemTimeToTzSpecificLocalTime（无第三方依赖）

Windows API 提供了原生时区转换能力，但只支持“本地 → 指定时区”或“UTC → 指定时区”，不直接支持“任意时区 A → 时区 B”。常见错误是误以为 SystemTimeToTzSpecificLocalTime 能把北京时间转成纽约时间——它只能把当前系统时区时间转成另一个时区的本地表示，前提是你知道源时间属于哪个时区。

实操建议：

先调用 GetTimeZoneInformation(&tzi) 获取当前系统时区偏移，用 FileTimeToLocalFileTime 把 FILETIME 转成本地 SYSTEMTIME，再用 SystemTimeToTzSpecificLocalTime(&tzi_ny, &st_local, &st_ny) 转纽约时间
TIME_ZONE_INFORMATION 结构体不含 IANA 名称（如 "America/New_York"），需自己维护映射表，或用 EnumDynamicTimeZoneInformation + GetDynamicTimeZoneInformation 获取更全信息
该方案无法处理夏令时历史变更（例如 2007 年前美国夏令时起止日不同），SystemTimeToTzSpecificLocalTime 只按当前规则计算

为什么不能只靠 time_t + offset 简单加减？

很多开发者试图用 time_t 加减 3600 * offset 小时来“模拟”时区转换，这在固定偏移场景（如 UTC+5:30）看似可行，但会在三类情况下彻底失效：

目标时区实行夏令时（DST）：例如德国在 3–10 月用 CEST（UTC+2），其余时间用 CET（UTC+1），硬编码 +7200 秒会错 3600 秒
时区历史变更：比如智利在 2015 年取消 DST，2022 年又恢复；俄罗斯在 2014 年废除永久夏令时；简单 offset 无法回溯
政治调整：2018 年北马其顿将时区从 CET 改为 CEST，2023 年委内瑞拉将 UTC-4.5 改为 UTC-4 —— 这些变动不会反映在编译时固定的 offset 里

IANA 时区数据库（tzdb）正是为解决这类问题存在，所有靠谱方案最终都依赖它，只是封装层级不同。