C语言时间处理与格式化输出：从入门到实践245

在C语言编程中，时间处理是一个非常常见的需求，无论是记录日志、显示当前日期时间、计算程序执行耗时，还是实现定时任务，都离不开对系统时间的获取、转换和格式化输出。C标准库通过<time.h>头文件提供了一套强大而灵活的函数和数据类型来满足这些需求。本文将作为一份全面的指南，带您深入了解C语言中如何有效地处理和输出时间点。

一、C语言时间的基础概念

在深入函数细节之前，我们首先需要理解C语言中表示时间的基本类型和概念：
时间戳（Epoch Time / Unix Timestamp）：这是一个自特定时间点（通常是1970年1月1日00:00:00 UTC，称为Unix纪元）以来经过的秒数。它是C语言中表示时间最原始和通用的方式，常通过time_t类型存储。
结构化时间（Broken-down Time）：这是一个将时间分解成年、月、日、时、分、秒等各个组成部分的结构体，方便人类阅读和处理。在C语言中，由struct tm类型表示。
本地时间（Local Time）：根据系统设置的时区和夏令时规则调整后的时间。
协调世界时（UTC / GMT）：一种标准的时间表示，不考虑地理位置和时区差异。

二、获取当前时间戳：time_t 与 time()

要获取当前的时间戳，我们主要使用time()函数。它返回一个time_t类型的值，表示自Unix纪元以来的秒数。
#include <stdio.h>
#include <time.h> // 包含time.h头文件
int main() {
time_t current_time; // 声明一个time_t类型的变量
current_time = time(NULL); // 获取当前时间戳，NULL表示不存储到特定位置
if (current_time != (time_t)-1) {
printf("当前时间戳（秒）：%ld", (long)current_time);
} else {
perror("获取时间失败");
}
return 0;
}

在上述代码中，time(NULL)会返回当前的日历时间。如果函数执行失败，它将返回(time_t)-1。time_t通常是一个长整型（long或long long），因此在printf中我们通常将其强制转换为long类型以便使用%ld格式化输出。

三、拆解时间：struct tm、localtime() 与 gmtime()

时间戳虽然精确，但对人类来说并不直观。为了方便处理年、月、日等组件，C语言提供了struct tm结构体和将其填充的函数。

3.1 struct tm 结构体详解

struct tm的定义大致如下：
struct tm {
int tm_sec; // 秒 (0-60, 60表示闰秒)
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：非夏令时，负值：未知)
};

需要注意的是，tm_mon是从0开始计数的（0代表1月），tm_year是从1900年开始计算的（例如，2023年是123）。

3.2 localtime()：转换为本地时间

localtime()函数将一个time_t时间戳转换为本地时间（考虑时区和夏令时）的struct tm结构体指针。
#include <stdio.h>
#include <time.h>
int main() {
time_t current_time = time(NULL);
if (current_time == (time_t)-1) {
perror("获取时间失败");
return 1;
}
struct tm *local_time_info;
local_time_info = localtime(&current_time); // 获取本地时间结构体指针
if (local_time_info == NULL) {
perror("转换本地时间失败");
return 1;
}
printf("本地时间：");
printf(" 年份: %d (自1900年)", local_time_info->tm_year);
printf(" 月份: %d (0-11)", local_time_info->tm_mon);
printf(" 日期: %d", local_time_info->tm_mday);
printf(" 小时: %d", local_time_info->tm_hour);
printf(" 分钟: %d", local_time_info->tm_min);
printf(" 秒钟: %d", local_time_info->tm_sec);
printf(" 星期: %d (0-6, 0是周日)", local_time_info->tm_wday);
printf(" 一年中的第几天: %d", local_time_info->tm_yday);
printf(" 夏令时: %d", local_time_info->tm_isdst);
// 为了更直观地输出，可以这样处理：
printf("本地时间 (格式化): %d年%d月%d日 %02d:%02d:%02d",
local_time_info->tm_year + 1900,
local_time_info->tm_mon + 1,
local_time_info->tm_mday,
local_time_info->tm_hour,
local_time_info->tm_min,
local_time_info->tm_sec);
return 0;
}

注意，localtime()返回的指针指向的是静态分配的struct tm结构体，这意味着在多线程环境中，如果多个线程同时调用localtime()，可能会导致数据竞争。在POSIX标准中，有线程安全的版本localtime_r()和gmtime_r()，它们需要用户提供一个struct tm缓冲区。

3.3 gmtime()：转换为UTC时间

gmtime()函数与localtime()类似，但它将time_t时间戳转换为UTC时间（协调世界时）的struct tm结构体指针。
#include <stdio.h>
#include <time.h>
int main() {
time_t current_time = time(NULL);
if (current_time == (time_t)-1) {
perror("获取时间失败");
return 1;
}
struct tm *utc_time_info;
utc_time_info = gmtime(&current_time); // 获取UTC时间结构体指针
if (utc_time_info == NULL) {
perror("转换UTC时间失败");
return 1;
}
printf("UTC时间 (格式化): %d年%d月%d日 %02d:%02d:%02d",
utc_time_info->tm_year + 1900,
utc_time_info->tm_mon + 1,
utc_time_info->tm_mday,
utc_time_info->tm_hour,
utc_time_info->tm_min,
utc_time_info->tm_sec);
return 0;
}

四、格式化输出时间：strftime() 的强大之处

直接打印struct tm的成员非常繁琐，并且不易于定制输出格式。C语言提供了strftime()函数，它类似于sprintf()，可以将struct tm中的时间信息按照指定的格式字符串输出到缓冲区中。
char *strftime(char *restrict s, size_t maxsize, const char *restrict format, const struct tm *restrict timeptr);


s：目标缓冲区，用于存放格式化后的时间字符串。
maxsize：目标缓冲区s的最大容量，包括终止空字符。
format：格式化字符串，由普通字符和特殊格式说明符组成。
timeptr：指向包含待格式化时间信息的struct tm结构体的指针。

如果成功，strftime()返回写入s的字符数（不包括终止空字符）；如果结果字符串长度超过maxsize，则返回0，且缓冲区内容未定义。

4.1 常用的格式说明符

以下是一些常用的strftime()格式说明符：
%Y：四位年份 (e.g., 2023)
%y：两位年份 (00-99)
%m：两位月份 (01-12)
%B：完整月份名称 (e.g., January)
%b：缩写月份名称 (e.g., Jan)
%d：两位日期 (01-31)
%e：日期，前面补空格 ( 1-31)
%H：24小时制小时 (00-23)
%I：12小时制小时 (01-12)
%M：两位分钟 (00-59)
%S：两位秒数 (00-60, 60表示闰秒)
%p：AM/PM 指示 (根据区域设置)
%w：一周中的第几天 (0-6, 0是周日)
%a：缩写星期几名称 (e.g., Sun)
%A：完整星期几名称 (e.g., Sunday)
%j：一年中的第几天 (001-366)
%U：一年中的第几周 (00-53, 周日为一周开始)
%W：一年中的第几周 (00-53, 周一为一周开始)
%c：标准日期和时间格式 (e.g., Sun Aug 19 02:14:00 2001)
%x：标准日期格式 (e.g., 08/19/01)
%X：标准时间格式 (e.g., 02:14:00)
%Z：时区名称或缩写 (e.g., EST)
%%：字面值 %

4.2 strftime() 示例

#include <stdio.h>
#include <time.h>
#include <stdlib.h> // For EXIT_SUCCESS/EXIT_FAILURE
int main() {
time_t current_time = time(NULL);
if (current_time == (time_t)-1) {
perror("获取时间失败");
return EXIT_FAILURE;
}
struct tm *local_time_info = localtime(&current_time);
if (local_time_info == NULL) {
perror("转换本地时间失败");
return EXIT_FAILURE;
}
char buffer[80]; // 足够大的缓冲区来存储时间字符串
// 格式化示例 1: "YYYY-MM-DD HH:MM:SS"
strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", local_time_info);
printf("格式化时间 (YYYY-MM-DD HH:MM:SS): %s", buffer);
// 格式化示例 2: "星期几, 月份 日, 年份 HH:MM:SS AM/PM"
strftime(buffer, sizeof(buffer), "%A, %B %d, %Y %I:%M:%S %p", local_time_info);
printf("格式化时间 (完整): %s", buffer);
// 格式化示例 3: ISO 8601 格式 "YYYY-MM-DDTHH:MM:SS" (加上时区)
// 注意: strftime本身不直接提供UTC偏移，%Z提供时区名称
strftime(buffer, sizeof(buffer), "%Y-%m-%dT%H:%M:%S%z", local_time_info);
printf("格式化时间 (ISO 8601近似): %s", buffer); // %z 打印UTC偏移
// 格式化示例 4: 仅日期
strftime(buffer, sizeof(buffer), "今天日期: %x", local_time_info);
printf("%s", buffer);
// 格式化示例 5: 仅时间
strftime(buffer, sizeof(buffer), "当前时间: %X", local_time_info);
printf("%s", buffer);
// 格式化示例 6: 自定义，包含周数和一年中的第几天
strftime(buffer, sizeof(buffer), "今天是今年的第%j天，本年的第%U周", local_time_info);
printf("%s", buffer);
return EXIT_SUCCESS;
}

strftime()是C语言处理时间输出最灵活和强大的工具，几乎可以满足所有常见的日期时间格式化需求。

五、时间点间的转换与计算

5.1 mktime()：将 struct tm 转换为 time_t

mktime()函数是localtime()的逆操作，它将一个本地时间的struct tm结构体转换为time_t时间戳。这在需要处理用户输入特定日期时间或进行时间验证时非常有用。

一个重要的特性是，mktime()会“规范化”struct tm结构体。例如，如果你设置tm_mday = 32，它会自动调整到下个月的日期。它还会根据tm_isdst的值调整夏令时。
#include <stdio.h>
#include <time.h>
#include <stdlib.h>
int main() {
struct tm custom_time = {0}; // 初始化为0
custom_time.tm_year = 2023 - 1900; // 2023年
custom_time.tm_mon = 10 - 1; // 10月 (0-based)
custom_time.tm_mday = 26; // 26日
custom_time.tm_hour = 14; // 14点
custom_time.tm_min = 30; // 30分
custom_time.tm_sec = 0; // 0秒
custom_time.tm_isdst = -1; // -1让mktime自行判断夏令时
time_t timestamp = mktime(&custom_time);
if (timestamp != (time_t)-1) {
printf("自定义时间戳: %ld", (long)timestamp);
// 验证转换后的时间是否正确
char buffer[80];
strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", &custom_time);
printf("验证格式化时间: %s", buffer);
} else {
perror("转换自定义时间失败");
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}

5.2 difftime()：计算时间差

difftime()函数用于计算两个time_t时间戳之间的差值，结果以double类型的秒数返回。
#include <stdio.h>
#include <time.h>
#include <unistd.h> // For sleep()
int main() {
time_t start_time, end_time;
double diff_seconds;
start_time = time(NULL); // 记录开始时间
if (start_time == (time_t)-1) {
perror("获取开始时间失败");
return 1;
}
printf("程序开始计时...");
sleep(3); // 暂停3秒钟
end_time = time(NULL); // 记录结束时间
if (end_time == (time_t)-1) {
perror("获取结束时间失败");
return 1;
}
diff_seconds = difftime(end_time, start_time); // 计算时间差
printf("程序执行了 %.2f 秒。", diff_seconds);
return 0;
}

六、测量程序执行时间：clock()

除了获取“墙上时间”（wall clock time），有时我们也需要测量CPU消耗的时间，这对于性能分析非常有用。clock()函数返回程序启动以来CPU时钟滴答数。要将其转换为秒，需要除以CLOCKS_PER_SEC宏。
#include <stdio.h>
#include <time.h>
int main() {
clock_t start_cpu_time, end_cpu_time;
double cpu_time_used;
long long i;
start_cpu_time = clock(); // 获取开始时的CPU时间
// 执行一些耗时操作
for (i = 0; i < 1000000000LL; i++) {
// 空循环，模拟CPU工作
}
end_cpu_time = clock(); // 获取结束时的CPU时间
if (start_cpu_time == (clock_t)-1 || end_cpu_time == (clock_t)-1) {
perror("获取CPU时间失败");
return 1;
}
cpu_time_used = ((double)(end_cpu_time - start_cpu_time)) / CLOCKS_PER_SEC;
printf("CPU 使用时间: %f 秒。", cpu_time_used);
return 0;
}

需要注意的是，clock()返回的是程序所使用的CPU时间，而不是实际经过的时间（墙上时间）。如果程序在等待I/O或被操作系统挂起，clock()报告的时间可能远小于实际经过的时间。

七、高级主题与注意事项
时区处理：localtime()会自动根据系统配置的时区来调整时间。如果需要临时修改时区，可以通过设置TZ环境变量来实现（例如，setenv("TZ", "Asia/Shanghai", 1); tzset();），但这种方法不总是可移植的，且不推荐在多线程应用中随意修改全局环境变量。更专业的时区处理通常需要引入第三方库。
线程安全：localtime()和gmtime()的返回值是指向静态存储的struct tm的指针，这在多线程环境中不是线程安全的。POSIX标准提供了线程安全的版本localtime_r()和gmtime_r()，它们要求调用者提供一个struct tm缓冲区。
精度问题：time()函数的精度通常是秒。如果需要更高精度的时间，例如毫秒、微秒或纳秒，需要使用操作系统特定的API，如POSIX的gettimeofday()或C11/C++11的<chrono>库。
错误处理：始终检查time()、localtime()、gmtime()等函数的返回值，以确保时间获取和转换成功。例如，time()失败返回(time_t)-1，localtime()和gmtime()失败返回NULL，strftime()返回0表示缓冲区不足。

八、总结

C语言的<time.h>库提供了一套完善的时间处理机制，从获取基本的时间戳到将其拆解为结构化时间，再到高度灵活的格式化输出，几乎涵盖了所有常见的时间点操作需求。

核心函数回顾：
time()：获取当前时间戳（time_t类型）。
localtime() / gmtime()：将时间戳转换为本地时间或UTC时间的struct tm结构体。
strftime()：最强大的时间格式化工具，将struct tm格式化为自定义字符串。
mktime()：将struct tm转换回time_t时间戳。
difftime()：计算两个时间戳之间的秒数差。
clock()：测量CPU消耗的时间。

掌握这些函数和概念，您就能在C语言项目中游刃有余地处理各种时间相关的任务。在实际开发中，请务必注意线程安全和错误处理，以构建健壮可靠的应用程序。

2025-11-05

---

上一篇：深入理解C语言中的`query`函数：数据检索的实践与高级技巧

下一篇：C语言实现英文短语缩写提取：从基础算法到高级优化与健壮性实践