C语言时间处理：time_t与struct tm详解及实践

1. C语言时间处理基础：time_t与struct tm的本质

在C语言中处理时间，本质上是在处理两种不同的时间表示形式：机器友好的时间戳（time_t）和人类友好的分解时间（struct tm）。理解它们的本质差异是避免时间处理bug的第一步。

time_t本质上是一个算术类型（通常是long或long long），表示从UNIX纪元（1970年1月1日00:00:00 UTC）到当前时刻的秒数。这个简单的数值有几个关键特性：

• 与时区无关（永远是UTC）
• 适合存储和计算
• 在32位系统上会在2038年溢出（著名的2038问题）

struct tm则是一个包含多个成员的结构体，将时间分解为人类易读的各个组成部分：

c复制struct tm {
    int tm_sec;    // 秒 [0,60]
    int tm_min;    // 分钟 [0,59]
    int tm_hour;   // 小时 [0,23]
    int tm_mday;   // 月中的第几天 [1,31]
    int tm_mon;    // 月份 [0,11]
    int tm_year;   // 年份 - 1900
    int tm_wday;   // 星期 [0,6]
    int tm_yday;   // 年中的第几天 [0,365]
    int tm_isdst;  // 夏令时标志
};

关键提示：struct tm的时区相关性取决于你使用的转换函数。gmtime()产生的struct tm表示UTC时间，而localtime()产生的struct tm表示本地时间。

2. 时间转换函数全解析：从原理到实践

2.1 time_t → struct tm转换

C标准库提供了两个主要函数来完成这个方向的转换：

1. gmtime() - 将time_t转换为UTC时间的struct tm
2. localtime() - 将time_t转换为本地时间的struct tm

这两个函数都有一个严重问题：它们返回指向静态缓冲区的指针，这意味着：

• 不是线程安全的（多线程同时调用会互相覆盖结果）
• 后续调用会覆盖之前的结果

现代代码应该使用它们的线程安全版本：

c复制st