C++ time_t转字符串格式 _ strftime函数自定义时间格式【干货】

strftime必须传入struct tm*指针，不能直接用time_t；需先调用localtime_r（POSIX）或localtime_s（Windows）转换，再检查返回值防缓冲区溢出。

strftime 函数的基本调用方式和必需参数

想把时间戳变成我们看得懂的日期字符串？C标准库里的strftime函数是绕不开的工具。但这里有个关键点必须拎清楚：它只认struct tm结构体指针，你直接把time_t丢给它可不行。这就像给咖啡机塞了一把咖啡豆，却不先研磨——机器不认，结果要么卡住，要么给你一杯“乱码”。

新手常犯的一个错误是这么写：strftime(buf, sizeof(buf), "%Y-%m-%d", time_ptr)。如果这里的time_ptr是个time_t*类型，代码虽然能编译，但运行起来就是“开盲盒”，崩溃或者输出一堆乱码是家常便饭。

• 所以，正确的第一步永远是：struct tm *tm_ptr = localtime(&t)（注意那个取地址符&不能少）。
• 第二步才是主角登场：strftime(buf, sizeof(buf), "%H:%M:%S", tm_ptr)。
• 这里还有两个细节：buf必须是个实实在在的字符数组（别用只读的字符串字面量），而且尺寸得留够。通常预留64字节比较稳妥，能应对绝大多数格式。
• 别忘了关注返回值，它告诉你实际写入了多少个字符（不包括结尾的\0）。如果返回0，那就要警惕了，要么是缓冲区太小装不下，要么就是你给的格式字符串有问题。

常用格式符与中文环境下的陷阱

strftime的格式符看似强大，但在中文环境下，尤其是跨平台时，坑可真不少。Windows和Linux对本地化（locale）的支持，差异大得像是两个世界。

举个例子，%A（星期全名）和%B（月份全名）在Linux上，只要你用setlocale(LC_TIME, "zh_CN.UTF-8")设置好，就能优雅地输出“星期一”、“十二月”。但在Windows的MSVC环境下，即便你设置了"Chinese_China.936"，它很可能还是给你返回空字符串或者一堆问号。

• 最稳妥的做法是什么？尽量避免依赖%A、%B来输出中文。不如自己建个表来映射，比如用weekdays[tm->tm_wday]，可控又可靠。
• %c这个符代表“本地日期时间格式”，但它的“本地”实现各平台各说各话。Linux可能输出“2024年12月01日 星期日 15:30:45”，而Windows很可能给你来个“12/01/2024 15:30:45”。想用它做跨平台方案？趁早打消这个念头。
• 想输出时区偏移量%z？在Windows上MSVC基本会忽略它；GCC/Clang虽然支持，但输出格式是+0800，而不是更标准的+08:00。
• 还有，strftime不支持毫秒！如果需要更高精度的时间，得自己手动拼接，比如用snprintf加上tv.tv_usec / 1000的计算结果。

线程安全与替代方案提醒

接下来要说的这个问题，在并发编程里堪称经典陷阱：localtime函数返回的是一个指向静态缓冲区的指针，这意味着它不是线程安全的。如果在多线程环境里并发调用，不同线程的数据会互相覆盖，导致出现一些看似灵异的事件，比如时间突然跳回1970年。

立即学习“C++免费学习笔记（深入）”；

• 在POSIX系统（如Linux）上，优先使用线程安全版本localtime_r(&t, &tm)（注意那个_r后缀），第二个参数tm是你自己分配的栈变量，安全无忧。
• Windows没有localtime_r，但提供了localtime_s(&tm, &t)（使用时可能需要定义_CRT_SECURE_NO_WARNINGS宏，或者直接使用安全版本函数）。
• 如果项目已经用上了C++20，那么std::format是更现代的选择：std::format("{:%Y-%m-%d %H:%M:%S}", std::chrono::system_clock::from_time_t(t))。不过要注意，这个特性在MSVC 2022 v17.8+和GCC 13+之后才比较稳定，老项目升级前得掂量一下。
• 最后提个醒，别用ctime来替代。它只能输出固定格式，而且同样存在线程安全问题。

一个最小可运行示例（含错误检查）

理论说了这么多，来看一段实实在在的代码。下面这个例子在Linux和Windows（MSVC）下都能编译通过并正确运行：

#include 
#include 
#include 

int main() {
    time_t t = std::time(nullptr);
    struct tm tm_buf;

#ifdef _WIN32
    localtime_s(&tm_buf, &t);
#else
    localtime_r(&t, &tm_buf);
#endif

    char buf[64];
    if (strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", &tm_buf) == 0) {
        std::cerr << "strftime failed: buffer too small or invalid format\n";
        return 1;
    }
    std::cout << buf << "\n";
}

这段代码里对strftime返回值的检查，看似微不足道，却至关重要。很多人会跳过这一步，但缓冲区溢出的风险就藏在这些细节里。尤其是当你动态拼接格式字符串的时候，长度估算稍有偏差，输出就会被无情截断。多一行检查，少一夜调试，这笔账怎么算都划算。