c语言strftime函数如何正确使用？

strftime 是 C 标准库中的一个非常有用的函数，它用于将 struct tm 结构体中的时间信息格式化成一个我们自定义的字符串，这在进行日志记录、显示时间戳等任务时非常常见。

函数原型

strftime 函数在 <time.h> 头文件中声明。

size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr);

参数详解

返回值

• 成功：返回写入到 str 缓冲区中的字符个数（不包括结尾的 \0）。
• 失败：如果生成的字符串长度（包括 \0）超过了 maxsize，则返回 0，str 的内容不会被修改（或修改不完整）。

格式说明符

strftime 的强大之处在于其丰富的格式说明符,下面是一些最常用的：

struct tm 结构体

strftime 的输入是 struct tm,这个结构体定义如下：

struct tm {
    int tm_sec;     // 秒 (0-59)
    int tm_min;     // 分钟 (0-59)
    int tm_hour;    // 小时 (0-23)
    int tm_mday;    // 一月中的第几天 (1-31)
    int tm_mon;     // 月份 (0-11, 0代表一月)
    int tm_year;    // 年份 (从1900年开始)
    int tm_wday;    // 一周中的第几天 (0-6, 0代表周日)
    int tm_yday;    // 一年中的第几天 (0-365)
    int tm_isdst;   // 夏令时标志 (>0: 夏令时, 0: 非夏令时, <0: 未知)
};

特别注意：tm_year 是从 1900 年开始的，所以如果你要表示 2025 年，tm_year 应该是 2025 - 1900 = 123。tm_mon 是从 0 开始的，10 月应该是 9。

完整示例代码

下面是一个完整的 C 语言示例，演示了如何使用 localtime() 获取本地时间，并用 strftime 进行格式化。

#include <stdio.h>
#include <time.h> // 包含 time.h 头文件
int main() {
    // 1. 获取当前时间（从1970年1月1日至今的秒数）
    time_t rawtime;
    time(&rawtime);
    // 2. 将 time_t 转换为本地时间的 struct tm 结构体
    struct tm *timeinfo = localtime(&rawtime);
    // 3. 定义一个足够大的缓冲区来存放格式化后的字符串
    char buffer[80];
    // 4. 使用 strftime 进行格式化
    // 格式: YYYY-MM-DD HH:MM:SS
    strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", timeinfo);
    printf("标准格式: %s\n", buffer);
    // 5. 另一种格式: Month Day, Year
    strftime(buffer, sizeof(buffer), "%B %d, %Y", timeinfo);
    printf("另一种格式: %s\n", buffer);
    // 6. 带星期的格式
    strftime(buffer, sizeof(buffer), "%a, %b %d, %Y", timeinfo);
    printf("带星期的格式: %s\n", buffer);
    // 7. 带时间的12小时制格式
    strftime(buffer, sizeof(buffer), "%I:%M:%S %p", timeinfo);
    printf("12小时制时间: %s\n", buffer);
    // 8. 测试缓冲区不足的情况
    // 格式字符串很长，超过了缓冲区大小
    strftime(buffer, 10, "This is a very long format string that will not fit", timeinfo);
    if (strftime(buffer, 10, "This is a very long format string that will not fit", timeinfo) == 0) {
        printf("缓冲区不足，格式化失败，\n");
    } else {
        printf("意外成功: %s\n", buffer);
    }
    return 0;
}

运行结果示例（会根据你的运行时间和系统语言环境有所不同）：

标准格式: 2025-10-27 15:30:45
另一种格式: October 27, 2025
带星期的格式: Fri, Oct 27, 2025
12小时制时间: 03:30:45 PM
缓冲区不足，格式化失败。

重要注意事项

1. 缓冲区大小：始终确保你的目标缓冲区 str 足够大，以容纳最坏情况下的格式化字符串，一个常见的做法是定义一个足够大的数组，char buffer[256];。
2. 返回值检查：在编程实践中，最好检查 strftime 的返回值，以防缓冲区溢出，如果返回值为 0,说明格式化失败。
3. localtime 的线程安全性：localtime 函数使用一个静态的内部缓冲区来存储结果，这在多线程程序中是不安全的，如果需要在多线程环境中使用，应该使用 localtime_r（POSIX 标准）或 localtime_s（MSVC 标准）等线程安全的替代函数。
4. 本地化：strftime 的输出（如 %A, %B, %p 等）会受到程序当前区域设置（locale）的影响，如果你需要固定为英文，可以在程序开始时调用 setlocale(LC_TIME, "C"); 或 setlocale(LC_TIME, "en_US.UTF-8");。

希望这个详细的解释能帮助你完全掌握 strftime 函数的使用！