到clock_gettime()的实战指南)
1. 项目缘起为什么“获取时间”是Linux C编程的必修课你可能觉得在程序里获取当前时间不就是调用一个函数的事儿吗有什么好讲的我刚开始接触Linux C编程时也是这么想的直到在一个真实的项目里踩了坑。当时需要写一个日志系统要求每条日志都精确到毫秒并且能处理跨时区用户的操作。我随手用了time()和localtime()上线后才发现日志时间对不上性能也有问题。这才让我意识到在Linux环境下用C语言处理时间远不是调用一两个函数那么简单它背后涉及系统调用、时区处理、精度选择、性能开销乃至线程安全等一系列问题。无论是写一个需要记录时间戳的日志模块还是开发一个定时执行任务的守护进程或者是实现一个高精度的时间间隔测量工具“获取时间”都是最基础、最核心的操作之一。网络上搜索“linux 常用命令”时date命令的使用频率很高这恰恰说明了时间操作在系统管理中的普遍性。而在编程层面我们需要更深入、更可控的方式。从简单的打印当前日期到复杂的性能剖析和分布式系统时钟同步时间函数是我们与操作系统时钟对话的桥梁。理解它们是写出健壮、高效C程序的关键一步。2. 时间概念的基石从日历时间到处理器滴答在动手写代码之前我们必须厘清Linux C中关于时间的几个核心概念。如果你混淆了它们就很容易写出有歧义或者错误的代码。2.1 日历时间Calendar Time这是我们最熟悉的时间概念即“年月日时分秒”。在C标准库中它通常用一个名为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 启用0 不启用0 未知 };需要注意的是tm_year是“1900年以来的年数”所以2024年对应的值是124。tm_mon从0开始这是很多初学者容易出错的地方。日历时间是人类可读的但它依赖于时区Time Zone和夏令时Daylight Saving Time规则同一时刻在不同地区字符串表示不同。2.2 时间戳Timestamp / Epoch Time为了有一个统一、简单的计时标准计算机世界引入了“时间戳”。在Linux和大多数Unix系统中最常用的就是“Unix时间戳”或Epoch Time。它表示自协调世界时UTC1970年1月1日 00:00:00以来所经过的秒数不考虑闰秒。这是一个整数类型通常是time_t在64位系统上通常是long。它的巨大优势在于唯一性和简单性。全球任何一台计算机在同一个瞬间理论上都应该得到相同或极其接近的Unix时间戳值。这非常适合于存储、计算时间间隔以及在不同系统间传递时间信息。我们后面会看到很多系统调用如获取文件修改时间的stat返回的就是这种时间戳。2.3 单调时间Monotonic Time与实时时间Real-Time Time这是理解高性能和可靠时间测量的关键。time()函数或gettimeofday()已废弃返回的是“实时时间”也就是我们墙上的挂钟时间。这个时间是可以被系统管理员或NTP网络时间协议调整的。想象一下你正在测量一段代码的执行耗时time_t start time(NULL); // ... 执行一些操作 time_t end time(NULL); double duration difftime(end, start);如果在你测量期间系统时间被人为调快了1小时那么计算出的duration可能就是负数或一个巨大的正数这显然是错误的。因此对于测量时间间隔如性能分析、超时控制必须使用单调时间。单调时间保证只增不减不受系统时间调整的影响。在Linux中我们使用clock_gettime()函数并指定CLOCK_MONOTONIC时钟源来获取它。这是编写稳健程序的一个重要习惯。2.4 时钟源与精度不同的时间函数其精度和开销也不同。time()精度是秒gettimeofday()精度是微秒而clock_gettime()可以到达纳秒级取决于硬件和内核支持。精度越高通常系统调用的开销也略大但在现代硬件上这种差异对于大多数应用可以忽略。选择哪种方式取决于你的实际需求如果只是记录到“天”用time()就够了如果需要记录日志时间到毫秒用gettimeofday()注意其非单调性或clock_gettime(CLOCK_REALTIME, ...)如果需要高精度测量耗时必须用clock_gettime(CLOCK_MONOTONIC, ...)。3. 核心函数库实战从time()到clock_gettime()理论铺垫完毕现在我们进入实战环节逐一拆解最常用的时间获取函数并分析其适用场景和坑点。3.1 基础入门time() 和 ctime()time()函数是最简单的它返回当前的Unix时间戳秒级。ctime()则直接将这个时间戳转换成本地时间的字符串格式。#include stdio.h #include time.h int main() { time_t now; time(now); // 也可以写成 now time(NULL); printf(Timestamp: %ld\n, (long)now); printf(Local time: %s, ctime(now)); // ctime() 自带换行符 return 0; }实操心得time()的参数可以是一个time_t变量的地址函数会将时间戳填入也可以传入NULL直接返回时间戳。两种方式都常见。ctime()返回的字符串是静态分配的例如static char buffer[26]这意味着它不是线程安全的。如果在多线程环境中并发调用ctime()、localtime()等函数结果可能会相互覆盖。对于多线程程序必须使用它们的可重入版本ctime_r()、localtime_r()。3.2 灵活转换localtime()、gmtime() 和 strftime()localtime()和gmtime()都用于将time_t时间戳转换为struct tm结构体。关键区别在于localtime()转换为本地时间依赖于系统的时区设置。gmtime()转换为UTC格林威治标准时间。#include stdio.h #include time.h int main() { time_t now time(NULL); struct tm *local_tm localtime(now); struct tm *utc_tm gmtime(now); printf(Local: %d-%02d-%02d %02d:%02d:%02d\n, local_tm-tm_year 1900, local_tm-tm_mon 1, local_tm-tm_mday, local_tm-tm_hour, local_tm-tm_min, local_tm-tm_sec); printf(UTC : %d-%02d-%02d %02d:%02d:%02d\n, utc_tm-tm_year 1900, utc_tm-tm_mon 1, utc_tm-tm_mday, utc_tm-tm_hour, utc_tm-tm_min, utc_tm-tm_sec); return 0; }踩坑点和ctime()一样localtime()和gmtime()返回指向静态存储区的指针也是非线程安全的。多线程环境下务必使用localtime_r()和gmtime_r()。strftime()函数则是格式化输出的神器它允许你按照自定义格式将struct tm输出为字符串。char buffer[80]; strftime(buffer, sizeof(buffer), %Y-%m-%d %H:%M:%S (Week %U), local_tm); printf(Formatted: %s\n, buffer);常用格式说明符%Y四位数的年份%m两位数的月份01-12%d两位数的日期01-31%H24小时制的小时00-23%M分钟00-59%S秒00-60%F等价于%Y-%m-%dISO 8601日期格式%T等价于%H:%M:%S3.3 微秒级精度gettimeofday()及其替代方案gettimeofday()曾经是获取微秒精度时间的标准函数它填充一个struct timeval结构体。#include sys/time.h #include stdio.h int main() { struct timeval tv; gettimeofday(tv, NULL); // 第二个参数时区已废弃传NULL printf(Seconds: %ld, Microseconds: %ld\n, tv.tv_sec, tv.tv_usec); return 0; }重要警告gettimeofday()函数在最新标准如POSIX.1-2008中已被标记为“废弃”obsolescent。主要原因有两个1) 它的第二个参数时区已不可靠且不应使用2) 更重要的是它返回的是“实时时间”如前所述这不是单调的可能发生跳变。因此在新代码中不建议再使用gettimeofday()。3.4 现代首选高精度与单调时钟 clock_gettime()这是目前Linux下获取时间的推荐方式功能强大且灵活。其原型为int clock_gettime(clockid_t clk_id, struct timespec *tp);struct timespec提供了秒和纳秒两个字段struct timespec { time_t tv_sec; // 秒 long tv_nsec; // 纳秒 [0, 999999999] };关键在于clk_id的选择它决定了你获取的是哪种时间CLOCK_REALTIME系统实时时间可被修改。相当于高精度版的time()。用于需要挂钟时间的场景。CLOCK_MONOTONIC单调时间从系统启动开始计算不受任何时间调整影响。用于测量时间间隔的首选。CLOCK_MONOTONIC_RAW类似CLOCK_MONOTONIC但不受NTP频率调整影响更“原始”的硬件时间。CLOCK_PROCESS_CPUTIME_ID本进程消耗的CPU时间。CLOCK_THREAD_CPUTIME_ID本线程消耗的CPU时间。示例测量代码段耗时正确做法#include time.h #include stdio.h void expensive_function() { // 模拟耗时操作 for (volatile int i 0; i 100000000; i); } int main() { struct timespec start, end; // 获取单调时钟开始时间 clock_gettime(CLOCK_MONOTONIC, start); expensive_function(); // 获取单调时钟结束时间 clock_gettime(CLOCK_MONOTONIC, end); // 计算耗时秒 double duration (end.tv_sec - start.tv_sec) (end.tv_nsec - start.tv_nsec) / 1e9; printf(Function took %.6f seconds.\n, duration); return 0; }编译注意使用clock_gettime()需要链接rt库Real Time library。gcc -o my_program my_program.c -lrt4. 进阶应用与性能剖析实战掌握了基础函数我们就可以解决一些更实际、更复杂的问题。这里我结合自己的项目经验分享几个典型场景。4.1 场景一构建一个线程安全、带毫秒精度的日志函数这是非常常见的需求。我们不能用ctime()或localtime()因为非线程安全。我们需要用它们的_r版本并结合clock_gettime获取高精度时间。#include time.h #include stdio.h #include string.h #include sys/syscall.h #include unistd.h void log_with_timestamp(const char* message) { struct timespec ts; struct tm tm_buf; char time_str[30]; // 1. 获取实时时间用于日期 clock_gettime(CLOCK_REALTIME, ts); // 2. 转换为本地时间线程安全版本 localtime_r(ts.tv_sec, tm_buf); // 3. 格式化日期部分 strftime(time_str, sizeof(time_str), %F %T, tm_buf); // 4. 获取当前线程ID可选便于调试 pid_t tid syscall(SYS_gettid); // 5. 打印日志[日期 时:分:秒.毫秒] [线程ID] 消息 printf([%s.%03ld] [%d] %s\n, time_str, ts.tv_nsec / 1000000, // 将纳秒转换为毫秒 tid, message); } int main() { log_with_timestamp(Application started.); // ... 一些操作 log_with_timestamp(Processing data...); return 0; }关键点解析线程安全使用localtime_r替代localtime。毫秒精度从timespec的tv_nsec字段纳秒除以1000000得到毫秒部分。注意tv_nsec范围是0-999,999,999所以除以100万后得到0-999的毫秒数。时间格式使用%F %T格式得到YYYY-MM-DD HH:MM:SS清晰且符合ISO标准。线程ID使用syscall(SYS_gettid)获取真实的线程ID比pthread_self()返回的ID更易读在/proc文件系统中可见。4.2 场景二精确计算程序/代码块的CPU执行时间有时我们关心的是代码实际消耗的CPU时间而不是墙上时钟时间Wall-clock Time。例如一个程序可能因为等待I/O而挂起墙上时钟时间很长但CPU时间很短。这时就需要进程/线程的CPU时间。#include time.h #include stdio.h #include unistd.h int main() { struct timespec cpu_start, cpu_end; double cpu_time_used; // 获取进程CPU时间开始点 clock_gettime(CLOCK_PROCESS_CPUTIME_ID, cpu_start); // ---- 要测量的代码块开始 ---- int sum 0; for (int i 0; i 100000000; i) { sum i; } // 模拟一些I/O等待不消耗CPU sleep(2); // ---- 要测量的代码块结束 ---- // 获取进程CPU时间结束点 clock_gettime(CLOCK_PROCESS_CPUTIME_ID, cpu_end); cpu_time_used (cpu_end.tv_sec - cpu_start.tv_sec) (cpu_end.tv_nsec - cpu_start.tv_nsec) / 1e9; printf(CPU time used by the loop (excluding sleep): %.6f seconds\n, cpu_time_used); // 对比墙上时钟时间 struct timespec wall_start, wall_end; clock_gettime(CLOCK_MONOTONIC, wall_start); // ... 同样的代码块 ... clock_gettime(CLOCK_MONOTONIC, wall_end); double wall_time_used (wall_end.tv_sec - wall_start.tv_sec) (wall_end.tv_nsec - wall_start.tv_nsec) / 1e9; printf(Wall-clock time used (including sleep): %.6f seconds\n, wall_time_used); return 0; }运行这个程序你会看到CPU时间远小于墙上时钟时间因为sleep不消耗CPU。这在性能优化中非常有用可以帮你定位是CPU计算瓶颈还是I/O等待瓶颈。4.3 场景三处理时区与国际化时间显示如果你的程序需要面向全球用户处理时区就不可避免。核心原则是在内部存储和计算时始终使用UTC时间戳time_t。只在需要显示给用户时才根据其所在时区转换为本地时间。错误做法在服务器上直接用localtime()转换时间戳并存储为字符串。当美国用户和北京用户查看同一条记录时他们会看到基于服务器时区的时间造成混乱。正确做法在数据库或内存中存储UTC时间戳time_t或格式化的UTC时间字符串如2024-05-27T10:30:00Z。当用户请求数据时前端或后端根据用户提供的时区偏移量如08:00或时区名称如Asia/Shanghai将UTC时间转换为对应的本地时间再显示。在C语言中虽然标准库对时区支持有限但我们可以通过设置环境变量TZ来临时改变程序的时区认知或者使用更强大的第三方库如ICU。一个简单的示例是使用tzset()和putenv()#include stdio.h #include stdlib.h #include time.h void print_time_in_timezone(time_t utc_time, const char* tz_name) { char old_tz[64] {0}; char* old_tz_ptr getenv(TZ); if (old_tz_ptr) { snprintf(old_tz, sizeof(old_tz), TZ%s, old_tz_ptr); } // 设置新的时区环境变量 setenv(TZ, tz_name, 1); tzset(); // 使时区设置生效 struct tm local_tm; localtime_r(utc_time, local_tm); char buf[64]; strftime(buf, sizeof(buf), %F %T %Z, local_tm); printf(Time in %s: %s\n, tz_name, buf); // 恢复原来的时区 if (old_tz[0] ! \0) { putenv(old_tz); } else { unsetenv(TZ); } tzset(); } int main() { time_t now time(NULL); // 获取当前UTC时间戳 printf(UTC timestamp: %ld\n, (long)now); print_time_in_timezone(now, America/New_York); print_time_in_timezone(now, Europe/London); print_time_in_timezone(now, Asia/Shanghai); return 0; }注意频繁修改环境变量TZ和调用tzset()在多线程环境下可能有风险且性能不高。生产环境中更推荐在后端使用专门的时区数据库如libtz或在应用层如使用Java/Python等高级语言进行时区转换。5. 常见陷阱、调试技巧与性能考量即使知道了所有函数在实际编码中依然会遇到各种问题。这里总结几个我踩过的坑和对应的解决方案。5.1 时间函数返回值处理与错误检查很多时间函数在失败时会返回特殊值但初学者常常忽略检查。time()如果失败返回(time_t)-1。虽然极少失败但严谨的程序应该检查。clock_gettime()成功返回0失败返回-1并设置errno。一定要检查返回值localtime_r()/gmtime_r()成功返回传入的struct tm*指针失败返回NULL例如传入的time_t值无法表示。struct timespec ts; if (clock_gettime(CLOCK_MONOTONIC, ts) -1) { perror(clock_gettime failed); // 处理错误可能使用备选方案或退出 }5.2 “Y2038问题”的幽灵在32位系统上time_t传统上被定义为有符号32位整数。它将在2038年1月19日 03:14:07 UTC之后溢出从2^31 - 1秒跳转到负数。这就是著名的“Y2038”问题。如何应对在64位系统上编程现代64位Linux系统通常将time_t定义为64位整数其表示范围可以到公元2920亿年在可预见的未来是安全的。这是最简单的解决方案。检查你的环境如果你必须兼容32位系统可以使用宏__TIME_BITS或检查sizeof(time_t)。如果sizeof(time_t) 4就要小心了。使用显式的64位类型对于需要长期存储的时间戳可以考虑直接使用int64_t或long long来存储从Epoch开始的毫秒或微秒数避免依赖time_t的尺寸。5.3 性能开销的权衡在性能敏感的循环中例如每处理一个请求都要打时间戳时间函数的开销需要考量。time(NULL)开销极小通常是一次快速的系统调用或甚至从用户空间的vsyscall中读取。clock_gettime(CLOCK_MONOTONIC, ts)在现代Linux内核支持vDSO上获取CLOCK_MONOTONIC和CLOCK_REALTIME通常也无需陷入内核开销与time()相当非常快。gettimeofday()虽然废弃但其开销也很低。localtime()/gmtime()及其_r版本相对较慢因为它们涉及复杂的时区规则计算。如果在一个紧凑循环中只需要时间戳或单调时间应避免反复调用它们。正确的做法是在循环外获取一次struct tm或者在循环内只调用clock_gettime()等需要输出时再批量转换。5.4 时间字符串格式化的选择使用strftime()时格式字符串的选择会影响解析的便利性和国际化。优先使用ISO 8601格式%Y-%m-%dT%H:%M:%SZUTC时间或%Y-%m-%dT%H:%M:%S%z带时区偏移。这种格式是国际标准排序正确按字典序就是时间序且被绝大多数编程语言和工具库直接支持。避免使用本地化的格式如%x本地日期格式、%X本地时间格式因为它们在不同地区环境locale下输出差异很大不利于日志解析和程序间交换。为日志文件命名一个常见的技巧是使用时间戳作为日志文件名的一部分例如app-20240527-153022.log。可以使用strftime生成这样的字符串。char log_filename[256]; time_t now time(NULL); struct tm tm_buf; localtime_r(now, tm_buf); strftime(log_filename, sizeof(log_filename), app-%F-%H%M%S.log, tm_buf); // 现在可以用 log_filename 来创建或打开日志文件了处理Linux C中的时间就像在操作系统的脉搏上搭脉。从简单的秒级时间戳到纳秒级的单调时钟从本地时间转换到时区处理每一步都需要对底层机制有清晰的认识。我个人的经验是在项目初期就明确时间需求需要什么精度是否需要单调性是否需要处理时区内部存储用什么格式回答好这些问题选择正确的函数和策略能避免后期大量的重构和调试。记住对于时间间隔测量CLOCK_MONOTONIC是你的好朋友对于存储和传输Unix时间戳UTC是通用语言而对于显示则要虔诚地对待时区。最后别忘了检查函数返回值并时刻对“Y2038”保持警惕尤其是在嵌入式或遗留系统中。把这些细节处理好你的程序在时间维度上就拥有了坚实的可靠性。 
长河君 · 2026/8/13 4:48:54 · 阅读 1.2k Linux C时间编程：从time()到clock_gettime()的实战指南
1. 项目缘起为什么“获取时间”是Linux C编程的必修课你可能觉得在程序里获取当前时间不就是调用一个函数的事儿吗有什么好讲的我刚开始接触Linux C编程时也是这么想的直到在一个真实的项目里踩了坑。当时需要写一个日志系统要求每条日志都精确到毫秒并且能处理跨时区用户的操作。我随手用了time()和localtime()上线后才发现日志时间对不上性能也有问题。这才让我意识到在Linux环境下用C语言处理时间远不是调用一两个函数那么简单它背后涉及系统调用、时区处理、精度选择、性能开销乃至线程安全等一系列问题。无论是写一个需要记录时间戳的日志模块还是开发一个定时执行任务的守护进程或者是实现一个高精度的时间间隔测量工具“获取时间”都是最基础、最核心的操作之一。网络上搜索“linux 常用命令”时date命令的使用频率很高这恰恰说明了时间操作在系统管理中的普遍性。而在编程层面我们需要更深入、更可控的方式。从简单的打印当前日期到复杂的性能剖析和分布式系统时钟同步时间函数是我们与操作系统时钟对话的桥梁。理解它们是写出健壮、高效C程序的关键一步。2. 时间概念的基石从日历时间到处理器滴答在动手写代码之前我们必须厘清Linux C中关于时间的几个核心概念。如果你混淆了它们就很容易写出有歧义或者错误的代码。2.1 日历时间Calendar Time这是我们最熟悉的时间概念即“年月日时分秒”。在C标准库中它通常用一个名为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 启用0 不启用0 未知 };需要注意的是tm_year是“1900年以来的年数”所以2024年对应的值是124。tm_mon从0开始这是很多初学者容易出错的地方。日历时间是人类可读的但它依赖于时区Time Zone和夏令时Daylight Saving Time规则同一时刻在不同地区字符串表示不同。2.2 时间戳Timestamp / Epoch Time为了有一个统一、简单的计时标准计算机世界引入了“时间戳”。在Linux和大多数Unix系统中最常用的就是“Unix时间戳”或Epoch Time。它表示自协调世界时UTC1970年1月1日 00:00:00以来所经过的秒数不考虑闰秒。这是一个整数类型通常是time_t在64位系统上通常是long。它的巨大优势在于唯一性和简单性。全球任何一台计算机在同一个瞬间理论上都应该得到相同或极其接近的Unix时间戳值。这非常适合于存储、计算时间间隔以及在不同系统间传递时间信息。我们后面会看到很多系统调用如获取文件修改时间的stat返回的就是这种时间戳。2.3 单调时间Monotonic Time与实时时间Real-Time Time这是理解高性能和可靠时间测量的关键。time()函数或gettimeofday()已废弃返回的是“实时时间”也就是我们墙上的挂钟时间。这个时间是可以被系统管理员或NTP网络时间协议调整的。想象一下你正在测量一段代码的执行耗时time_t start time(NULL); // ... 执行一些操作 time_t end time(NULL); double duration difftime(end, start);如果在你测量期间系统时间被人为调快了1小时那么计算出的duration可能就是负数或一个巨大的正数这显然是错误的。因此对于测量时间间隔如性能分析、超时控制必须使用单调时间。单调时间保证只增不减不受系统时间调整的影响。在Linux中我们使用clock_gettime()函数并指定CLOCK_MONOTONIC时钟源来获取它。这是编写稳健程序的一个重要习惯。2.4 时钟源与精度不同的时间函数其精度和开销也不同。time()精度是秒gettimeofday()精度是微秒而clock_gettime()可以到达纳秒级取决于硬件和内核支持。精度越高通常系统调用的开销也略大但在现代硬件上这种差异对于大多数应用可以忽略。选择哪种方式取决于你的实际需求如果只是记录到“天”用time()就够了如果需要记录日志时间到毫秒用gettimeofday()注意其非单调性或clock_gettime(CLOCK_REALTIME, ...)如果需要高精度测量耗时必须用clock_gettime(CLOCK_MONOTONIC, ...)。3. 核心函数库实战从time()到clock_gettime()理论铺垫完毕现在我们进入实战环节逐一拆解最常用的时间获取函数并分析其适用场景和坑点。3.1 基础入门time() 和 ctime()time()函数是最简单的它返回当前的Unix时间戳秒级。ctime()则直接将这个时间戳转换成本地时间的字符串格式。#include stdio.h #include time.h int main() { time_t now; time(now); // 也可以写成 now time(NULL); printf(Timestamp: %ld\n, (long)now); printf(Local time: %s, ctime(now)); // ctime() 自带换行符 return 0; }实操心得time()的参数可以是一个time_t变量的地址函数会将时间戳填入也可以传入NULL直接返回时间戳。两种方式都常见。ctime()返回的字符串是静态分配的例如static char buffer[26]这意味着它不是线程安全的。如果在多线程环境中并发调用ctime()、localtime()等函数结果可能会相互覆盖。对于多线程程序必须使用它们的可重入版本ctime_r()、localtime_r()。3.2 灵活转换localtime()、gmtime() 和 strftime()localtime()和gmtime()都用于将time_t时间戳转换为struct tm结构体。关键区别在于localtime()转换为本地时间依赖于系统的时区设置。gmtime()转换为UTC格林威治标准时间。#include stdio.h #include time.h int main() { time_t now time(NULL); struct tm *local_tm localtime(now); struct tm *utc_tm gmtime(now); printf(Local: %d-%02d-%02d %02d:%02d:%02d\n, local_tm-tm_year 1900, local_tm-tm_mon 1, local_tm-tm_mday, local_tm-tm_hour, local_tm-tm_min, local_tm-tm_sec); printf(UTC : %d-%02d-%02d %02d:%02d:%02d\n, utc_tm-tm_year 1900, utc_tm-tm_mon 1, utc_tm-tm_mday, utc_tm-tm_hour, utc_tm-tm_min, utc_tm-tm_sec); return 0; }踩坑点和ctime()一样localtime()和gmtime()返回指向静态存储区的指针也是非线程安全的。多线程环境下务必使用localtime_r()和gmtime_r()。strftime()函数则是格式化输出的神器它允许你按照自定义格式将struct tm输出为字符串。char buffer[80]; strftime(buffer, sizeof(buffer), %Y-%m-%d %H:%M:%S (Week %U), local_tm); printf(Formatted: %s\n, buffer);常用格式说明符%Y四位数的年份%m两位数的月份01-12%d两位数的日期01-31%H24小时制的小时00-23%M分钟00-59%S秒00-60%F等价于%Y-%m-%dISO 8601日期格式%T等价于%H:%M:%S3.3 微秒级精度gettimeofday()及其替代方案gettimeofday()曾经是获取微秒精度时间的标准函数它填充一个struct timeval结构体。#include sys/time.h #include stdio.h int main() { struct timeval tv; gettimeofday(tv, NULL); // 第二个参数时区已废弃传NULL printf(Seconds: %ld, Microseconds: %ld\n, tv.tv_sec, tv.tv_usec); return 0; }重要警告gettimeofday()函数在最新标准如POSIX.1-2008中已被标记为“废弃”obsolescent。主要原因有两个1) 它的第二个参数时区已不可靠且不应使用2) 更重要的是它返回的是“实时时间”如前所述这不是单调的可能发生跳变。因此在新代码中不建议再使用gettimeofday()。3.4 现代首选高精度与单调时钟 clock_gettime()这是目前Linux下获取时间的推荐方式功能强大且灵活。其原型为int clock_gettime(clockid_t clk_id, struct timespec *tp);struct timespec提供了秒和纳秒两个字段struct timespec { time_t tv_sec; // 秒 long tv_nsec; // 纳秒 [0, 999999999] };关键在于clk_id的选择它决定了你获取的是哪种时间CLOCK_REALTIME系统实时时间可被修改。相当于高精度版的time()。用于需要挂钟时间的场景。CLOCK_MONOTONIC单调时间从系统启动开始计算不受任何时间调整影响。用于测量时间间隔的首选。CLOCK_MONOTONIC_RAW类似CLOCK_MONOTONIC但不受NTP频率调整影响更“原始”的硬件时间。CLOCK_PROCESS_CPUTIME_ID本进程消耗的CPU时间。CLOCK_THREAD_CPUTIME_ID本线程消耗的CPU时间。示例测量代码段耗时正确做法#include time.h #include stdio.h void expensive_function() { // 模拟耗时操作 for (volatile int i 0; i 100000000; i); } int main() { struct timespec start, end; // 获取单调时钟开始时间 clock_gettime(CLOCK_MONOTONIC, start); expensive_function(); // 获取单调时钟结束时间 clock_gettime(CLOCK_MONOTONIC, end); // 计算耗时秒 double duration (end.tv_sec - start.tv_sec) (end.tv_nsec - start.tv_nsec) / 1e9; printf(Function took %.6f seconds.\n, duration); return 0; }编译注意使用clock_gettime()需要链接rt库Real Time library。gcc -o my_program my_program.c -lrt4. 进阶应用与性能剖析实战掌握了基础函数我们就可以解决一些更实际、更复杂的问题。这里我结合自己的项目经验分享几个典型场景。4.1 场景一构建一个线程安全、带毫秒精度的日志函数这是非常常见的需求。我们不能用ctime()或localtime()因为非线程安全。我们需要用它们的_r版本并结合clock_gettime获取高精度时间。#include time.h #include stdio.h #include string.h #include sys/syscall.h #include unistd.h void log_with_timestamp(const char* message) { struct timespec ts; struct tm tm_buf; char time_str[30]; // 1. 获取实时时间用于日期 clock_gettime(CLOCK_REALTIME, ts); // 2. 转换为本地时间线程安全版本 localtime_r(ts.tv_sec, tm_buf); // 3. 格式化日期部分 strftime(time_str, sizeof(time_str), %F %T, tm_buf); // 4. 获取当前线程ID可选便于调试 pid_t tid syscall(SYS_gettid); // 5. 打印日志[日期 时:分:秒.毫秒] [线程ID] 消息 printf([%s.%03ld] [%d] %s\n, time_str, ts.tv_nsec / 1000000, // 将纳秒转换为毫秒 tid, message); } int main() { log_with_timestamp(Application started.); // ... 一些操作 log_with_timestamp(Processing data...); return 0; }关键点解析线程安全使用localtime_r替代localtime。毫秒精度从timespec的tv_nsec字段纳秒除以1000000得到毫秒部分。注意tv_nsec范围是0-999,999,999所以除以100万后得到0-999的毫秒数。时间格式使用%F %T格式得到YYYY-MM-DD HH:MM:SS清晰且符合ISO标准。线程ID使用syscall(SYS_gettid)获取真实的线程ID比pthread_self()返回的ID更易读在/proc文件系统中可见。4.2 场景二精确计算程序/代码块的CPU执行时间有时我们关心的是代码实际消耗的CPU时间而不是墙上时钟时间Wall-clock Time。例如一个程序可能因为等待I/O而挂起墙上时钟时间很长但CPU时间很短。这时就需要进程/线程的CPU时间。#include time.h #include stdio.h #include unistd.h int main() { struct timespec cpu_start, cpu_end; double cpu_time_used; // 获取进程CPU时间开始点 clock_gettime(CLOCK_PROCESS_CPUTIME_ID, cpu_start); // ---- 要测量的代码块开始 ---- int sum 0; for (int i 0; i 100000000; i) { sum i; } // 模拟一些I/O等待不消耗CPU sleep(2); // ---- 要测量的代码块结束 ---- // 获取进程CPU时间结束点 clock_gettime(CLOCK_PROCESS_CPUTIME_ID, cpu_end); cpu_time_used (cpu_end.tv_sec - cpu_start.tv_sec) (cpu_end.tv_nsec - cpu_start.tv_nsec) / 1e9; printf(CPU time used by the loop (excluding sleep): %.6f seconds\n, cpu_time_used); // 对比墙上时钟时间 struct timespec wall_start, wall_end; clock_gettime(CLOCK_MONOTONIC, wall_start); // ... 同样的代码块 ... clock_gettime(CLOCK_MONOTONIC, wall_end); double wall_time_used (wall_end.tv_sec - wall_start.tv_sec) (wall_end.tv_nsec - wall_start.tv_nsec) / 1e9; printf(Wall-clock time used (including sleep): %.6f seconds\n, wall_time_used); return 0; }运行这个程序你会看到CPU时间远小于墙上时钟时间因为sleep不消耗CPU。这在性能优化中非常有用可以帮你定位是CPU计算瓶颈还是I/O等待瓶颈。4.3 场景三处理时区与国际化时间显示如果你的程序需要面向全球用户处理时区就不可避免。核心原则是在内部存储和计算时始终使用UTC时间戳time_t。只在需要显示给用户时才根据其所在时区转换为本地时间。错误做法在服务器上直接用localtime()转换时间戳并存储为字符串。当美国用户和北京用户查看同一条记录时他们会看到基于服务器时区的时间造成混乱。正确做法在数据库或内存中存储UTC时间戳time_t或格式化的UTC时间字符串如2024-05-27T10:30:00Z。当用户请求数据时前端或后端根据用户提供的时区偏移量如08:00或时区名称如Asia/Shanghai将UTC时间转换为对应的本地时间再显示。在C语言中虽然标准库对时区支持有限但我们可以通过设置环境变量TZ来临时改变程序的时区认知或者使用更强大的第三方库如ICU。一个简单的示例是使用tzset()和putenv()#include stdio.h #include stdlib.h #include time.h void print_time_in_timezone(time_t utc_time, const char* tz_name) { char old_tz[64] {0}; char* old_tz_ptr getenv(TZ); if (old_tz_ptr) { snprintf(old_tz, sizeof(old_tz), TZ%s, old_tz_ptr); } // 设置新的时区环境变量 setenv(TZ, tz_name, 1); tzset(); // 使时区设置生效 struct tm local_tm; localtime_r(utc_time, local_tm); char buf[64]; strftime(buf, sizeof(buf), %F %T %Z, local_tm); printf(Time in %s: %s\n, tz_name, buf); // 恢复原来的时区 if (old_tz[0] ! \0) { putenv(old_tz); } else { unsetenv(TZ); } tzset(); } int main() { time_t now time(NULL); // 获取当前UTC时间戳 printf(UTC timestamp: %ld\n, (long)now); print_time_in_timezone(now, America/New_York); print_time_in_timezone(now, Europe/London); print_time_in_timezone(now, Asia/Shanghai); return 0; }注意频繁修改环境变量TZ和调用tzset()在多线程环境下可能有风险且性能不高。生产环境中更推荐在后端使用专门的时区数据库如libtz或在应用层如使用Java/Python等高级语言进行时区转换。5. 常见陷阱、调试技巧与性能考量即使知道了所有函数在实际编码中依然会遇到各种问题。这里总结几个我踩过的坑和对应的解决方案。5.1 时间函数返回值处理与错误检查很多时间函数在失败时会返回特殊值但初学者常常忽略检查。time()如果失败返回(time_t)-1。虽然极少失败但严谨的程序应该检查。clock_gettime()成功返回0失败返回-1并设置errno。一定要检查返回值localtime_r()/gmtime_r()成功返回传入的struct tm*指针失败返回NULL例如传入的time_t值无法表示。struct timespec ts; if (clock_gettime(CLOCK_MONOTONIC, ts) -1) { perror(clock_gettime failed); // 处理错误可能使用备选方案或退出 }5.2 “Y2038问题”的幽灵在32位系统上time_t传统上被定义为有符号32位整数。它将在2038年1月19日 03:14:07 UTC之后溢出从2^31 - 1秒跳转到负数。这就是著名的“Y2038”问题。如何应对在64位系统上编程现代64位Linux系统通常将time_t定义为64位整数其表示范围可以到公元2920亿年在可预见的未来是安全的。这是最简单的解决方案。检查你的环境如果你必须兼容32位系统可以使用宏__TIME_BITS或检查sizeof(time_t)。如果sizeof(time_t) 4就要小心了。使用显式的64位类型对于需要长期存储的时间戳可以考虑直接使用int64_t或long long来存储从Epoch开始的毫秒或微秒数避免依赖time_t的尺寸。5.3 性能开销的权衡在性能敏感的循环中例如每处理一个请求都要打时间戳时间函数的开销需要考量。time(NULL)开销极小通常是一次快速的系统调用或甚至从用户空间的vsyscall中读取。clock_gettime(CLOCK_MONOTONIC, ts)在现代Linux内核支持vDSO上获取CLOCK_MONOTONIC和CLOCK_REALTIME通常也无需陷入内核开销与time()相当非常快。gettimeofday()虽然废弃但其开销也很低。localtime()/gmtime()及其_r版本相对较慢因为它们涉及复杂的时区规则计算。如果在一个紧凑循环中只需要时间戳或单调时间应避免反复调用它们。正确的做法是在循环外获取一次struct tm或者在循环内只调用clock_gettime()等需要输出时再批量转换。5.4 时间字符串格式化的选择使用strftime()时格式字符串的选择会影响解析的便利性和国际化。优先使用ISO 8601格式%Y-%m-%dT%H:%M:%SZUTC时间或%Y-%m-%dT%H:%M:%S%z带时区偏移。这种格式是国际标准排序正确按字典序就是时间序且被绝大多数编程语言和工具库直接支持。避免使用本地化的格式如%x本地日期格式、%X本地时间格式因为它们在不同地区环境locale下输出差异很大不利于日志解析和程序间交换。为日志文件命名一个常见的技巧是使用时间戳作为日志文件名的一部分例如app-20240527-153022.log。可以使用strftime生成这样的字符串。char log_filename[256]; time_t now time(NULL); struct tm tm_buf; localtime_r(now, tm_buf); strftime(log_filename, sizeof(log_filename), app-%F-%H%M%S.log, tm_buf); // 现在可以用 log_filename 来创建或打开日志文件了处理Linux C中的时间就像在操作系统的脉搏上搭脉。从简单的秒级时间戳到纳秒级的单调时钟从本地时间转换到时区处理每一步都需要对底层机制有清晰的认识。我个人的经验是在项目初期就明确时间需求需要什么精度是否需要单调性是否需要处理时区内部存储用什么格式回答好这些问题选择正确的函数和策略能避免后期大量的重构和调试。记住对于时间间隔测量CLOCK_MONOTONIC是你的好朋友对于存储和传输Unix时间戳UTC是通用语言而对于显示则要虔诚地对待时区。最后别忘了检查函数返回值并时刻对“Y2038”保持警惕尤其是在嵌入式或遗留系统中。把这些细节处理好你的程序在时间维度上就拥有了坚实的可靠性。