Linux下的C语言不仅有时间函数，而且同时具备C标准库与POSIX标准两套接口。标准库提供time、localtime、gmtime、strftime、clock等函数，POSIX还扩展了gettimeofday、clock_gettime等更高精度的接口。掌握它们能够覆盖日志时间戳、程序耗时统计、定时控制等大部分开发场景。
一、C标准库中的基础时间函数
C标准库通过<time.h>头文件暴露了时间处理能力。最核心的是time函数，它返回从1970年1月1日00:00:00 UTC到当前的日历时间，类型是time_t，通常是一个长整型。这个时间戳不依赖时区，适合做差值计算。
拿到time_t之后，如果希望转成人类可读的年月日时分秒，可以使用localtime或gmtime。前者转成本地时区，后者转成UTC。返回值是struct tm指针，该结构体包含tm_year、tm_mon等字段，注意年份是从1900年起算，月份是0到11。下面是一段基础示例：
#include <stdio.h>
#include <time.h>
int main(void) {
time_t now = time(NULL);
if (now == (time_t)-1) {
return 1;
}
struct tm *local = localtime(&now);
printf("当前本地时间：%d-%02d-%02d %02d:%02d:%02dn",
local->tm_year + 1900,
local->tm_mon + 1,
local->tm_mday,
local->tm_hour,
local->tm_min,
local->tm_sec);
return 0;
}
使用localtime要注意它不是线程安全的，因为返回的是指向静态内存的指针。在多线程程序中应改用localtime_r，它把结果写入调用者提供的struct tm对象，避免竞争。这是Linux下C语言开发常见的坑。
另一个常用函数是strftime，它按照格式字符串把struct tm输出成自定义文本，比手动拼字段更安全直观。clock函数则统计程序消耗的CPU时间，类型为clock_t，适合做算法性能对比，但不包含休眠或等待I/O的时间。
二、Linux POSIX扩展的高精度时间函数
当秒级精度不够时，POSIX提供的gettimeofday可以拿到微秒级时间，定义在<sys/time.h>。它填充struct timeval，包含tv_sec和tv_usec两个字段。虽然在新代码中更推荐clock_gettime，但很多旧项目仍在使用。
clock_gettime基于clockid_t选择时钟源，例如CLOCK_REALTIME代表系统实时钟，CLOCK_MONOTONIC代表单调时钟，不受系统时间修改影响，非常适合测量时间间隔。下面示例展示如何计算某段代码耗时：
#include <stdio.h>
#include <time.h>
int main(void) {
struct timespec start, end;
clock_gettime(CLOCK_MONOTONIC, &start);
// 模拟工作
for (volatile long i = 0; i < 100000000; i++);
clock_gettime(CLOCK_MONOTONIC, &end);
long sec = end.tv_sec - start.tv_sec;
long nsec = end.tv_nsec - start.tv_nsec;
if (nsec < 0) {
sec--;
nsec += 1000000000L;
}
printf("耗时：%ld秒 %ld纳秒n", sec, nsec);
return 0;
}
相比gettimeofday，clock_gettime支持多种时钟且能达到纳秒级，而且可以通过clock_getres查询精度。在编写定时器或性能探针时应优先采用。需要注意的是编译时可能要链接rt库，即gcc加上-lrt参数，不过较新glibc已将其并入主库。
如果要做周期性任务，还可以配合nanosleep进行高精度休眠，它不会像sleep那样容易被信号中断后少睡，且支持纳秒级控制。整体来看，Linux下C语言时间函数体系完整，从粗略日志到精细性能分析都能胜任。
三、常见误区与选型建议
不少初学者把time(NULL)返回的time_t直接当本地时间打印，结果出现时区偏差，其实它只是UTC秒数。也有人用difftime做时间差，却忽略它返回的是double秒，不适合高精度场景。对于耗时统计，应优先选CLOCK_MONOTONIC而非CLOCK_REALTIME，避免用户修改系统时间导致负值。
在多线程服务程序中，尽量避开localtime、gmtime、asctime等非可重入函数，改用带_r后缀版本。如果只需要相对时间而不关心日历，clock或clock_gettime的单调时钟比任何日历函数都简单可靠。下表列出主要函数特点：
| 函数 | 精度 | 线程安全 | 主要用途 |
|---|---|---|---|
| time | 秒 | 是 | 时间戳、差值 |
| localtime_r | 秒 | 是 | 转本地可读时间 |
| gettimeofday | 微秒 | 是 | 旧式高精度时间 |
| clock_gettime | 纳秒 | 是 | 耗时、定时 |
| clock | 依赖实现 | 是 | CPU占用统计 |
综合来看，Linux下的C语言时间函数不仅存在，而且层次丰富。理解标准库与POSIX差异、可重入问题和时钟源特性，就能写出健壮的时间相关代码。
LinuxC_languagetime_function修改时间：2026-08-05 03:24:26