std::gmtime直接将time_t解释为UTC时间，而非将本地时间转为UTC；正确转换需先用std::mktime将本地tm转为time_t，再用std::gmtime解析为UTC tm。
用 std::gmtime 转换本地时间结构体时，别忘了先用 std::localtime 提取本地时间
直接对任意时间戳调用 std::gmtime 得到的是该时间戳对应的 UTC 时间结构体，不是“把本地时间转成 UTC”——它根本不知道你脑子里想的是本地时间。真正要做的，是先拿到本地时间（比如 time_t 值），再把它当作“本地解释的时间点”，反向算出这个时间点在 UTC 下对应什么。
常见错误是：拿到 time(nullptr) 后直接传给 std::gmtime，结果发现和 std::localtime 输出几乎一样（尤其在 UTC+0 时区）。这是因为 std::gmtime 把输入的 time_t 当作 UTC 时间戳来解析，而 time_t 本身是自 epoch 起的秒数，与本地/UTC 无关。
-
time_t是绝对时间，不带时区信息 -
std::localtime把time_t按当前系统时区解释为本地日历时间 -
std::gmtime把同一time_t按 UTC 解释为日历时间 - 所以：同一个
time_t，localtime和gmtime返回的tm结构体不同，差的就是时区偏移
用 std::mktime + std::gmtime 实现“本地日历时间 → UTC 时间戳”的转换
如果你手头是一个本地日历时间（比如用户输入的“2024-06-15 14:30:00”），且明确这是本地时间，需要转成 UTC 对应的 time_t，不能直接塞进 std::gmtime —— 它只接受 time_t，不接受 tm。
正确做法是：先用 std::mktime 把本地 tm 转成 time_t（它会按本地时区理解并归一化），再用 std::gmtime 把这个 time_t 解析为 UTC 日历时间。
立即学习“C++免费学习笔记（深入）”；
tm local_tm = {};
local_tm.tm_year = 2024 - 1900;
local_tm.tm_mon = 5; // June
local_tm.tm_mday = 15;
local_tm.tm_hour = 14;
local_tm.tm_min = 30;
local_tm.tm_sec = 0;
local_tm.tm_isdst = -1; // 让 mktime 自动判断夏令时
<p>time_t utc_timestamp = mktime(&local_tm); // 注意：mktime 修改 local_tm，设为本地时间对应的标准 time_t
tm* utc_tm = gmtime(&utc_timestamp); // 这才是 UTC 日历时间-
mktime输入是本地日历时间，输出是绝对时间戳（time_t） -
gmtime输入是绝对时间戳，输出是 UTC 日历时间 -
tm_isdst = -1必须设置，否则夏令时判断可能出错 -
mktime会修改传入的tm结构体（归一化字段），不要依赖原始值
C++20 <chrono> 的 zoned_time 更安全，但要注意时区数据库路径
如果你用的是 C++20 或更高标准，std::chrono::zoned_time 是更现代、更不易出错的方式。它显式绑定时区，避免隐式依赖系统 locale 或环境变量。
#include <chrono>
#include <date/date.h> // 需要 date 库（非标准，但被广泛采用）
<p>auto local = std::chrono::local_days{2024y/June/15} + 14h + 30min;
auto zt = date::zoned_time{"Asia/Shanghai", local}; // 显式指定本地时区
auto utc_time = zt.get_utc_time(); // 直接得到 UTC 时间点- 标准 C++20 尚未内置完整时区支持，
<chrono>中的zoned_time依赖实现（如 libc++ 支持，MSVC 不完全支持） - 实际项目中常借助 Howard Hinnant 的
date库，需额外编译或链接 - 时区名（如
"Asia/Shanghai"）必须真实存在，否则构造失败；可用date::get_tzdb().zones查看支持列表 - 注意：系统时区数据库（如
/usr/share/zoneinfo）路径需可访问，容器环境容易缺失
跨平台时，std::putenv("TZ=UTC") 不可靠，别这么干
有人试图通过修改 TZ 环境变量强制改变 localtime/gmtime 行为，这是危险操作：它影响整个进程甚至共享库，且 POSIX 规定 tzset() 必须被显式调用才生效，而 C++ 标准库不保证调用它。
-
putenv("TZ=UTC")后不调tzset()，localtime可能仍用旧时区 - 多线程下修改
TZ会导致竞态，localtime是非线程安全的 - Windows 不支持
TZ环境变量，行为不可移植 - 真正需要动态时区切换时，应使用
date::locate_zone()或平台 API（如 Windows 的GetTimeZoneInformation）
时区转换的核心陷阱不在函数调用本身，而在对 time_t 本质的理解——它只是秒数，所有“本地”“UTC”语义都来自你用哪个函数去解释它。一旦混淆输入意图和函数契约，结果必然偏差数小时。
