C语言时间格式化：strftime函数详解与实例

Cora

发布时间：2026-10-14 | 3人浏览过

原创

C语言提供了强大的标准库函数来处理日期和时间，其中 `strftime` 是进行时间格式转换的关键工具。本文将深入解析该函数的使用方法和典型应用场景。

核心概念与功能

在C语言开发中，获取当前时间通常涉及两个步骤：首先获取原始的时间戳（time_t），然后将其转换为本地时间和日期结构（struct tm）。要将这个结构体数据转化为人类可读的字符串格式，`strftime` 函数是最佳选择。

函数原型与参数解析

`strftime` 函数的定义位于标准库 time.h 中。其调用形式如下：

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

各参数的具体含义与作用如下：

char* ptr：指向目标字符数组的指针，用于存储格式化后的时间字符串。
size_t maxsize：缓冲区 ptr 的最大容量。此参数至关重要，用于防止写入溢出。如果格式化后的字符串长度超过此值，函数将返回0。
const char* format：格式化控制字符串。支持多种占位符（如 %Y 代表年份，%m 代表月份，%d 代表日期等）来组合输出的样式。
const struct tm* timeptr：指向已填充数据的 struct tm 结构体的指针，包含了分解后的年月日时分秒信息。

第1步：准备环境并引入头文件

在进行时间操作前，必须确保引入了正确的标准库头文件，以访问相关的数据结构和函数声明。

#include <stdio.h>
#include <time.h>

第2步：获取当前时间结构体

首先调用 time() 获取当前的日历时间，随后使用 localtime() 将其转换为表示本地时间的 struct tm 结构体。这一步是格式化前的必要预处理。

第3步：调用 strftime 执行格式化

分配一个足够大的字符数组作为缓冲区，并在调用时传入其大小限制。这能有效避免内存安全风险。

完整代码示例

以下是一个标准的 C 语言程序实现，展示了如何获取系统时间并将其格式化为 “年/月/日时:分:秒” 的形式打印输出：

#include <stdio.h>
#include <time.h>

int main ()
{
    time_t rawtime;
    struct tm * timeinfo;
    char buffer [128];

    // 1. 获取当前时间点
    time (&rawtime);
    
    // 2. 转换为本地时间结构体
    timeinfo = localtime (&rawtime);

    // 3. 按照指定格式进行时间字符串格式化
    // 注意第二个参数 sizeof(buffer) 用于限制最大写入长度
    strftime (buffer,sizeof(buffer),"Now is %Y/%m/%d %H:%M:%S",timeinfo);
    
    // 4. 输出结果
    puts (buffer);

    return 0;
}

在该示例中：
- %Y 替换为四位数的年份。
- %m 替换为两位数的月份（01-12）。
- %d 替换为两位数的日期（01-31）。
- %H, %M, %S 分别对应小时、分钟和秒。