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

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

如何将C/C++中的时间戳（time_t）转换为可读的日期时间字符串？标准库函数strftime是实现这一功能的核心工具。然而，开发者必须明确一个关键限制：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通常意味着缓冲区空间不足或格式字符串无效，这是排查错误的重要依据。

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

strftime的格式控制符功能强大，但在中文或跨平台开发场景中，存在不少兼容性陷阱。Windows与Linux/Unix系统在本地化（locale）支持上的差异尤为明显。

例如，格式符%A（星期全称）和%B（月份全称）在Linux上，通过setlocale(LC_TIME, "zh_CN.UTF-8")设置后，可以正确输出中文。但在Windows的MSVC环境下，即使设置了中文locale，输出结果仍可能为空或乱码。

• 最可靠的解决方案是：避免直接依赖%A、%B输出本地化名称。建议使用自定义的查找表进行映射，例如weekdays[tm->tm_wday]，以确保输出的稳定性和可控性。
• 格式符%c表示“本地化的日期时间表示”，但其具体格式因平台和locale设置而异，不具备跨平台一致性。不建议在需要固定格式的场景中使用。
• 时区偏移格式符%z在Windows MSVC中通常不被支持；在GCC/Clang中虽能输出，但格式可能为+0800而非ISO 8601标准的+08:00。
• 需要特别注意：strftime不支持毫秒或微秒精度。如果需要更高精度的时间字符串，需要结合其他函数（如gettimeofday）手动拼接。

线程安全与替代方案提醒

在多线程编程中，时间转换函数存在一个经典的安全隐患：标准C库函数localtime返回指向静态缓冲区的指针，这意味着它是非线程安全的。多线程并发调用会导致数据竞争和覆盖，产生错误的时间结果。

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

• 在POSIX兼容系统（如Linux）上，应使用线程安全版本localtime_r(&t, &tm)。该函数将结果存入用户提供的struct tm变量中，从而避免竞争。
• 在Windows平台上，应使用安全函数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))。请注意编译器版本兼容性。
• 最后提醒，不要使用ctime函数作为替代，它不仅格式固定，同样存在线程安全问题。

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

以下提供一个完整、健壮且跨平台（Linux/Windows）的C++代码示例，演示如何安全地将time_t转换为字符串：

#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的返回值可能导致缓冲区溢出或输出被意外截断，尤其是在动态生成格式字符串时。良好的错误处理是构建稳定C/C++应用程序的基础。