在C++开发中，获取当前时间的毫秒级时间戳是一项基础但容易写错的操作。标准库从C++11开始引入了chrono时间库，其中system_clock和duration_cast的组合能够干净地实现这一需求。理解它们之间的关系，可以帮助我们写出跨平台且不易溢出的时间获取代码。
一、system_clock与duration_cast基础原理
system_clock是C++标准库中表示系统墙上时钟的时钟类，它对应的是操作系统提供的当前日历时间。调用system_clock::now()会返回一个time_point对象，这个对象内部记录了从纪元（通常是1970-01-01 00:00:00 UTC）开始经过的时间。不过time_point本身并不带单位语义，它依赖于时钟的period参数来决定最小精度。
duration_cast是一个编译期模板函数，用来在不同的duration类型之间进行精度转换。比如从纳秒转毫秒，或者从秒转毫秒。它的作用是把一种表示时间长度的duration，安全地转换为另一种representation和period的duration。对于时间戳获取来说，我们一般先用time_point::time_since_epoch()拿到从纪元到现在的duration，再用duration_cast<milliseconds>把它转成毫秒单位的duration，最后调用count()提取整数值。
二、标准获取毫秒时间戳的写法
下面是一个跨平台、符合C++11及以上标准的写法。它不依赖任何第三方库，在Linux、Windows和macOS的主流编译器上都能正确编译运行。
#include <iostream>
#include <chrono>
// 获取当前毫秒级时间戳，返回自纪元以来的毫秒数
long long getCurrentMillis() {
// 获取系统时钟的当前时间点
auto now = std::chrono::system_clock::now();
// 计算从纪元到现在的时长，并转换为毫秒
auto ms = std::chrono::duration_cast<std::chrono::milliseconds>(
now.time_since_epoch()
);
// 返回毫秒计数
return ms.count();
}
int main() {
long long ts = getCurrentMillis();
std::cout << "current millis: " << ts << std::endl;
return 0;
}
这段代码中，duration_cast显式指定了目标类型为milliseconds，也就是std::chrono::milliseconds。count()返回的是该duration内部存储的整数值，类型由Rep参数决定，默认是long long。在绝大多数平台上，这个值足以覆盖到公元两亿年之后的时间，因此不用担心溢出问题。
有些开发者喜欢用time(NULL)乘以1000来模拟毫秒时间戳，这种做法在精度上只能到秒，而且如果系统时间被回调，time(NULL)也会跟着变，不适合做性能计时。而system_clock虽然也会受系统时间修改影响，但至少能提供亚秒级精度，更适合日志和业务流程中的时间标记。
三、常见错误与避坑指南
第一个常见错误是忘记使用duration_cast，直接对time_since_epoch().count()取值。由于system_clock的period在不同平台可能是微秒或纳秒，直接count会得到错误数量级的时间值。
#include <chrono>
long long wrongMillis() {
// 错误：未转换单位，在Linux上period常为纳秒
return std::chrono::system_clock::now()
.time_since_epoch()
.count(); // 可能是纳秒数而非毫秒数
}
第二个错误是误用steady_clock来获取墙上时间。steady_clock保证单调不回退，适合测量耗时，但它不代表真实世界时间，不能用来生成日历时间戳。如果你用steady_clock的time_since_epoch去算毫秒，得到的只是系统启动以来的毫秒，而非Unix时间戳。
| 时钟类型 | 是否受系统时间修改影响 | 适合用途 |
|---|---|---|
| system_clock | 是 | 日历时间、毫秒时间戳 |
| steady_clock | 否 | 间隔测量、性能统计 |
| high_resolution_clock | 视实现而定 | 最高精度计时 |
四、封装为易用工具函数
在真实项目中，我们通常会把时间戳获取封装到一个工具类或命名空间里，避免业务代码到处写chrono细节。同时可以提供秒级和毫秒级两种接口，方便不同场景调用。
#include <chrono>
namespace time_util {
// 毫秒级时间戳
long long millis() {
return std::chrono::duration_cast<std::chrono::milliseconds>(
std::chrono::system_clock::now().time_since_epoch()
).count();
}
// 秒级时间戳
long long seconds() {
return std::chrono::duration_cast<std::chrono::seconds>(
std::chrono::system_clock::now().time_since_epoch()
).count();
}
}
这种封装方式将标准库细节隔离在time_util内部，调用方只需要写time_util::millis()即可。如果未来标准库接口变化，或者需要切换到更高精度时钟，也只需修改一处实现。对于需要记录请求处理耗时的服务，建议配合steady_clock单独写一个elapsedMillis接口，用于区间计时，与墙上时间解耦。
总结来说，使用system_clock配合duration_cast是C++中获取毫秒级时间戳的标准做法。只要记住先做time_since_epoch再显式转换单位，就能避开绝大多数平台差异导致的坑。在性能敏感路径中，可以适当缓存时间戳而非每次调用，以减少系统调用开销。
C++system_clockduration_cast修改时间：2026-08-04 08:54:26