C++20下MSVC兼容的本地时间与UTC Unix时间戳互转方案

核心需求 #

• 实现指定时区的本地时间字符串 ↔ UTC Unix时间戳（支持1970年前的负int64秒数）
• 解决现有基于Howard Hinnant思路的代码在std::format/parse环节的报错
• 验证并替换现有Unix时间戳获取函数为简洁现代的实现

问题分析与解决方案 #

1. 时区处理与跨版本兼容 #

MSVC对C++20 <chrono>的时区支持需注意：必须使用Windows 10 1903+ SDK，编译时启用/std:c++20或更高版本。旧代码报错大概率是时区数据库未正确加载，或是std::chrono::parse的格式字符串不符合MSVC解析规则。

2. 本地时间字符串转UTC Unix时间戳 #

使用std::chrono::zoned_time结合std::chrono::parse，适配MSVC格式规则并支持负时间戳：

#include <chrono>
#include <format>
#include <string>
#include <sstream>
#include <stdexcept>

int64_t local_time_to_unix(const std::string& local_str, const std::string& tz_name) {
    try {
        const auto tz = std::chrono::locate_zone(tz_name);
        std::chrono::local_time<std::chrono::seconds> lt;
        std::istringstream iss(local_str);
        // 格式需与输入字符串严格匹配，示例为"%Y-%m-%d %H:%M:%S"
        iss >> std::chrono::parse("%Y-%m-%d %H:%M:%S", lt);
        if (!iss) {
            throw std::invalid_argument("Invalid time string format");
        }
        auto zt = std::chrono::zoned_time<std::chrono::seconds>(tz, lt);
        auto utc_sys = zt.get_sys_time();
        const auto unix_epoch = std::chrono::sys_time<std::chrono::seconds>(std::chrono::seconds{0});
        return (utc_sys - unix_epoch).count();
    } catch (...) {
        throw std::runtime_error("Failed to convert local time to Unix timestamp");
    }
}

3. UTC Unix时间戳转本地时间字符串 #

利用std::chrono::zoned_time和std::format，原生支持负时间戳：

std::string unix_to_local_time(int64_t unix_sec, const std::string& tz_name) {
    try {
        const auto tz = std::chrono::locate_zone(tz_name);
        auto sys_time = std::chrono::sys_time<std::chrono::seconds>(std::chrono::seconds{unix_sec});
        auto zt = std::chrono::zoned_time<std::chrono::seconds>(tz, sys_time);
        // 输出格式可自定义，示例含时区缩写
        return std::format("%Y-%m-%d %H:%M:%S %Z", zt);
    } catch (...) {
        throw std::runtime_error("Failed to convert Unix timestamp to local time");
    }
}

4. 现有Unix时间戳获取函数验证与替换 #

基于std::chrono::system_clock的现代实现，天然支持1970年前的负时间戳：

int64_t get_current_unix_timestamp() {
    const auto now = std::chrono::system_clock::now();
    const auto unix_epoch = std::chrono::system_clock::time_point();
    return std::chrono::duration_cast<std::chrono::seconds>(now - unix_epoch).count();
}

该实现无需依赖std::time_t（部分平台为32位，无法表示负时间），兼容性更强。

关键注意事项 #

• MSVC下确保时区数据可用：Windows 10 1903+会自动加载时区数据库，旧系统需手动部署时区文件。
• 格式字符串必须与输入/输出时间格式严格匹配，若字符串含时区缩写，需在parse时添加%Z。
• 处理1970年前的时间时，必须使用std::chrono::seconds作为时间精度单位，避免溢出。

测试示例 #

#include <iostream>

int main() {
    try {
        // 测试1969年UTC负时间戳
        const int64_t neg_ts = -31536000; // 1969-01-01 00:00:00 UTC
        const std::string ny_time = unix_to_local_time(neg_ts, "America/New_York");
        std::cout << "UTC " << neg_ts << " → NY time: " << ny_time << std::endl;

        // 反向转换验证
        const int64_t converted_ts = local_time_to_unix("1968-12-31 19:00:00", "America/New_York");
        std::cout << "NY time 1968-12-31 19:00:00 → UTC timestamp: " << converted_ts << std::endl;
    } catch (const std::exception& e) {
        std::cerr << "Error: " << e.what() << std::endl;
        return 1;
    }
    return 0;
}

预期输出：

UTC -31536000 → NY time: 1968-12-31 19:00:00 EST
NY time 1968-12-31 19:00:00 → UTC timestamp: -31536000

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