如何使用Howard Hinnant库为无时区壁钟时间添加DST时区修正

你的问题核心是纽约时区DST切换导致的缺失时间区间处理错误：2021年3月14日2:00-3:00是纽约时区的DST切换窗口，这个时间段在本地时间中不存在，常规转换逻辑会把壁钟的2:00错误映射到4:00，而正确结果应该是3:00。结合date/tz.h的info结构体，可按以下方案解决：

核心转换逻辑 #

无时区无DST的壁钟时间，本质是纽约标准时间（UTC-5，不随DST变化），正确转换路径应为：

1. 壁钟时间 → 转换为UTC时间（壁钟时间 + 5小时）
2. UTC时间 → 通过时区转换为纽约本地时间（自动应用DST偏移）

UTC时间是连续无歧义的，date/tz.h的时区转换会自动处理DST切换，避免缺失/重叠区间的错误映射。

代码实现（结合info结构体优化） #

#include <date/tz.h>
#include <iostream>
#include <chrono>

using namespace date;
using namespace std::chrono;

// 转换无时区壁钟时间（纽约标准时间）到纽约本地带DST时间
sys_time<seconds> wall_time_to_ny(local_seconds wall_time) {
    // 提前获取纽约时区对象（可全局缓存，避免重复查询）
    static const auto ny_tz = get_tzdb().lookup("America/New_York");
    
    // 壁钟时间是纽约标准时间，转UTC：标准时间=UTC-5 → UTC=标准时间+5h
    auto utc_time = wall_time + hours(5);
    
    // 利用info结构体验证DST状态（可选，用于日志或特殊场景）
    auto dst_info = ny_tz.get_info(utc_time);
    if (dst_info.is_dst) {
        // 当前UTC时间对应纽约DST生效状态，偏移为UTC-4
    }
    
    // UTC转纽约本地时间，自动处理DST
    return ny_tz.to_local(utc_time);
}

int main() {
    // 测试输入：2021-03-14 02:00 壁钟时间
    auto wall_input = local_days{March/14/2021} + hours(2);
    auto ny_result = wall_time_to_ny(wall_input);
    
    // 输出：2021-03-14 03:00
    std::cout << format("%Y-%m-%d %H:%M", ny_result) << std::endl;
    return 0;
}

利用info结构体高效批量处理 #

如果需要批量转换大量时间，可提前缓存目标年份的DST起止信息，减少重复查询：

// 缓存2021年纽约时区的DST信息
auto ny_tz = get_tzdb().lookup("America/New_York");
auto year_2021_info = ny_tz.get_info(year_month_day{2021_y, January, 1});

// year_2021_info包含：
// - begin: DST开始的UTC时间（对应纽约本地3月14日3:00）
// - end: DST结束的UTC时间（对应纽约本地11月7日2:00）
// - offset: 标准时间偏移（UTC-5）
// - save: DST额外偏移（+1h）

// 批量转换时，可先判断壁钟时间对应的UTC是否在DST区间内，直接计算本地时间：
auto wall_time = local_days{March/14/2021} + hours(2);
auto utc_time = wall_time + hours(5);
if (utc_time >= year_2021_info.begin && utc_time < year_2021_info.end) {
    // DST生效，本地时间=UTC-4
    auto ny_time = utc_time - hours(4);
} else {
    // 标准时间，本地时间=UTC-5
    auto ny_time = utc_time - hours(5);
}

错误原因复盘 #

你之前的代码大概率是直接将壁钟时间当作纽约本地时间（带DST）进行转换，而纽约时区中2021-03-14 02:00是不存在的时间点，date/tz.h会将其映射到下一个有效的本地时间（04:00），导致结果不符合预期。

内容的提问来源于stack exchange，提问作者tech1978