time() 返回自 Unix 纪元起的秒级 UTC 时间戳,类型为 time_t;需毫秒精度用 std::chrono::system_clock::now(),本地时间转换须调用 localtime_r() 等函数。

time() 函数返回的是秒级时间戳,不是毫秒或微秒
time() 是 C 标准库函数,定义在 中,返回自 Unix 纪元(1970-01-01 00:00:00 UTC)起经过的秒数,类型为 time_t。它不提供毫秒精度,也不能直接获取本地时区时间——返回值始终是 UTC 秒数(尽管 time_t 本身是算术类型,具体实现可能为 int64_t 或 long)。
常见误用是以为 time(nullptr) 能拿到带毫秒的当前时间,结果发现两次调用相同、日志时间戳全堆在整秒上。
- 需要毫秒级时间戳,请改用
std::chrono::system_clock::now() - 想格式化输出本地时间?先用
localtime()或localtime_r()转换,别直接对time_t做字符串拼接 - 跨平台注意:
time_t在 Windows 上可能是 64 位,但旧 MSVC 编译器(如 VS2015 以前)默认 32 位,2038 年问题仍需警惕
time(nullptr) 和 time(&t) 的行为差异
两者都返回当前时间的 time_t 值,区别仅在于是否写入用户提供的变量:
-
time(nullptr):只返回值,不修改任何内存;最常用,也最安全 -
time(&t):把值同时存入t,并返回该值;适合需要复用同一变量多次获取时间的场景(比如性能采样),但要注意t必须已声明且可写
错误示例:
time_t *t = nullptr; time(t); // 段错误!传入空指针给非 nullptr 版本会未定义行为
立即学习“C++免费学习笔记(深入)”;
正确写法:
time_t t; time(&t); // 或更简洁地:t = time(nullptr);
time() 获取的时间是 UTC,不是本地时间
time() 本身不涉及时区——它返回的是协调世界时(UTC)秒数。所谓“本地时间”必须靠后续转换函数实现:
-
localtime():线程不安全,返回指向静态缓冲区的struct tm*,多线程下可能被覆盖 -
localtime_r()(POSIX)或localtime_s()(Windows):线程安全,需传入用户分配的struct tm缓冲区 - 不要用
asctime()直接打印localtime()结果——它返回的字符串带换行符,且缓冲区固定大小,易溢出
推荐做法:
time_t now = time(nullptr); struct tm lt = {}; localtime_r(&now, <); // Linux/macOS
int year = lt.tm_year + 1900; int month = lt.tm_mon + 1; int day = lt.tm_mday;
C++11 后优先用 std::chrono,而非 time()
time() 是 C 风格接口,类型模糊、精度固定、无时区抽象。C++11 起,std::chrono 提供更清晰、类型安全、高精度的替代方案:
-
std::chrono::system_clock::now().time_since_epoch().count()返回纳秒级整数(具体单位取决于实现,通常为纳秒) - 转为秒级时间戳(等效于
time(nullptr)):auto now = std::chrono::system_clock::now();
std::time_t t = std::chrono::system_clock::to_time_t(now); - 避免隐式类型转换错误:
std::chrono::seconds和std::chrono::milliseconds是不同类型,编译期就报错
真正需要时间戳做日志、文件名、HTTP 头时,用 std::chrono::system_clock::to_time_t() 最稳妥;需要毫秒差值做性能统计?直接用 duration_cast。
time() 没过时,但它的“简单”背后藏着时区陷阱和精度盲区——尤其当项目开始支持多时区或需要 sub-second 日志时,绕不开 chrono。











