第9章时间与日期

课程目录第9章时间与日期

时间与日期：std::chrono跨平台使用、高精度计时器、时区处理

时间处理，说实话，是跨平台开发里最容易翻车的地方之一。我见过太多项目，明明业务逻辑没问题，一换平台就崩，最后发现是时间函数搞的鬼。Windows 用 GetTickCount，Linux 用 clock_gettime，macOS 又一套——这种碎片化，真的让人头大。

好在 C++11 开始，标准库给了我们 std::chrono。这玩意儿一出，跨平台时间处理终于有了统一解法。今天我就把这几年的实战经验掰开揉碎，跟你聊聊怎么用好它。

std::chrono 的核心三件套

说白了，std::chrono 就三个东西：时钟、时长、时间点。你只要搞懂这三者的关系，剩下的就是查表了。

组件	作用	常见类型
时钟（Clock）	提供当前时间点	`system_clock`、`steady_clock`、`high_resolution_clock`
时长（Duration）	表示时间间隔	`nanoseconds`、`microseconds`、`milliseconds`、`seconds`
时间点（Time Point）	某个时钟下的具体时刻	`time_point<Clock, Duration>`

重要原则：不同时钟的时间点不能直接比较或赋值。这是新手最容易踩的坑——我见过有人把 system_clock::now() 和 steady_clock::now() 做减法，结果编译报错还一脸懵。

高精度计时器：别再自己写 gettimeofday 了

我以前做游戏引擎时，需要精确到微秒级的帧率统计。早期代码里全是平台相关的宏定义，维护起来简直噩梦。后来全部换成 std::chrono，清爽多了。

给你看一个我项目里实际在用的高精度计时器：

#include <chrono>
#include <thread>

class HighPrecisionTimer {
public:
    using Clock = std::chrono::high_resolution_clock;
    using TimePoint = Clock::time_point;
    using Duration = std::chrono::microseconds;

    HighPrecisionTimer() : running_(false) {}

    void start() {
        start_time_ = Clock::now();
        running_ = true;
    }

    void stop() {
        end_time_ = Clock::now();
        running_ = false;
    }

    // 返回微秒数
    int64_t elapsed_us() const {
        auto end = running_ ? Clock::now() : end_time_;
        return std::chrono::duration_cast<Duration>(end - start_time_).count();
    }

    // 返回毫秒数（浮点精度）
    double elapsed_ms() const {
        auto end = running_ ? Clock::now() : end_time_;
        return std::chrono::duration_cast<std::chrono::duration<double, std::milli>>(end - start_time_).count();
    }

    // 忙等待直到指定微秒数到达
    void wait_until(int64_t us) {
        auto target = start_time_ + Duration(us);
        while (Clock::now() < target) {
            // 忙等，适合微秒级精确等待
            std::this_thread::yield();
        }
    }

private:
    TimePoint start_time_;
    TimePoint end_time_;
    bool running_;
};

我的习惯：计时器类里永远保留 running_ 状态。为什么？因为我在项目中遇到过析构时还在计时的 bug，加上状态判断能避免很多未定义行为。

时钟选择：别迷信 high_resolution_clock

很多人一上来就用 high_resolution_clock，觉得名字带 "high" 就牛逼。其实不然。我踩过这个坑——在某个嵌入式 Linux 平台上，high_resolution_clock 底层就是 system_clock，精度根本没提升，反而因为系统时间调整导致计时跳跃。

记住这个选择原则：

测量耗时、性能分析 → 用 steady_clock（单调递增，不受系统时间影响）
获取日历时间、日志时间戳 → 用 system_clock（可以转换到 time_t）
需要最高精度且不关心单调性 → 用 high_resolution_clock（但先查文档确认实现）

注意：steady_clock 保证单调性，但它的起点不固定。你不能拿它算 "今天是哪一天"。反过来，system_clock 可以转成日历时间，但可能被用户或 NTP 调整，导致计时出现负值。

时区处理：C++20 之前怎么办？

说实话，C++20 之前的 std::chrono 对时区支持几乎为零。标准库只给了你 UTC 时间，时区转换全靠自己。我在做跨国 SaaS 平台时，被时区问题折磨得不轻。

如果你还在用 C++17 及以下，我的建议是：

内部统一用 UTC 存储——所有时间戳、数据库字段、日志记录，一律 UTC。显示时再转本地时间。
用 IANA 时区数据库——别自己写时区规则，那玩意儿变化太频繁。推荐 date 库（Howard Hinnant 写的，C++20 chrono 的前身）。
小心夏令时——我曾经在项目里硬编码了 "北京时间 = UTC+8"，结果某年某个国家改了夏令时规则，日志时间全乱了。

给你看一个用 date 库处理时区的例子：

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

// 需要链接 -lcurl 和 -ldate-tz
void print_local_time() {
    using namespace date;
    using namespace std::chrono;

    // 获取当前 UTC 时间
    auto utc_time = system_clock::now();

    // 转换到指定时区
    auto local_time = make_zoned("Asia/Shanghai", utc_time);

    // 格式化输出
    std::cout << format("%F %T %Z", local_time) << std::endl;
    // 输出示例：2025-01-15 14:30:00 CST
}

避坑指南：我曾经在 Docker 容器里跑这个代码，发现时区数据库没装，直接抛异常。后来我养成了习惯——在程序启动时检查时区数据是否可用，不可用则回退到 UTC。

知识体系总览

下面这张图，是我自己整理的时间处理知识结构。你照着这个思路学，不会乱。

实战：跨平台毫秒级定时器

最后，给你一个我目前在用的跨平台定时器封装。它不依赖任何平台 API，纯标准库实现：

#include <chrono>
#include <functional>
#include <thread>
#include <atomic>

class CrossPlatformTimer {
public:
    using Clock = std::chrono::steady_clock;

    CrossPlatformTimer() : running_(false) {}

    ~CrossPlatformTimer() {
        stop();
    }

    // 启动定时器，interval_ms 为间隔毫秒数
    void start(int interval_ms, std::function<void()> callback) {
        if (running_.load()) return;
        
        running_.store(true);
        thread_ = std::thread([this, interval_ms, callback]() {
            auto next_time = Clock::now();
            while (running_.load()) {
                next_time += std::chrono::milliseconds(interval_ms);
                callback();
                // 精确休眠到下一个时间点
                std::this_thread::sleep_until(next_time);
            }
        });
    }

    void stop() {
        running_.store(false);
        if (thread_.joinable()) {
            thread_.join();
        }
    }

private:
    std::atomic<bool> running_;
    std::thread thread_;
};

关键点：用 sleep_until 而不是 sleep_for。为什么？因为 sleep_for 每次休眠固定时长，如果回调执行时间长了，误差会累积。sleep_until 每次都睡到绝对时间点，误差不会扩散。这个细节，是我在做一个音频采样程序时血泪换来的教训。

好了，时间处理这块，核心就是这些。记住：统一用 UTC 存，显示时再转；性能测量用 steady_clock；高精度计时用 sleep_until 避免误差累积。做到这三点，跨平台时间处理基本不会出大问题。

公众号:蓝海资料掘金营，微信deep3321

📚 课程目录

时间与日期：std::chrono跨平台使用、高精度计时器、时区处理

std::chrono 的核心三件套

高精度计时器：别再自己写 gettimeofday 了

时钟选择：别迷信 high_resolution_clock

时区处理：C++20 之前怎么办？

知识体系总览

实战：跨平台毫秒级定时器