时间与日期：time.h 与平台特定API、高精度计时器
时间处理，在跨平台开发里是个容易踩坑的地方。我刚开始做跨平台项目时，就吃过这个亏——Windows 上跑得好好的定时逻辑，到了 Linux 上直接乱套。后来才明白，不同操作系统对时间的理解，其实差别挺大的。
今天咱们就把这块彻底捋清楚。从标准库 time.h 讲起，再到平台特定的高精度计时器，最后给出一个跨平台的封装方案。
一、标准库 time.h：跨平台的基石
time.h 是 C 标准库的一部分，理论上所有平台都支持。它提供了最基础的时间函数：time()、localtime()、strftime() 等等。
但说实话，time.h 的精度只有秒级。对于大部分业务场景够用，可一旦涉及到性能测试、动画帧率控制、音频同步这些场景，秒级精度就完全不够看了。
核心函数速览：
time_t time(time_t *t)：获取当前日历时间（秒）struct tm *localtime(const time_t *t)：转换为本地时间结构体double difftime(time_t t1, time_t t2)：计算时间差（秒）size_t strftime(char *s, size_t max, const char *fmt, const struct tm *tm)：格式化时间字符串
#include <stdio.h>
#include <time.h>
int main() {
time_t now = time(NULL);
struct tm *local = localtime(&now);
char buf[64];
strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", local);
printf("当前时间：%s\n", buf);
return 0;
}这段代码在任何平台上都能编译运行。但注意，time() 返回的是自 1970-01-01 00:00:00 UTC 以来的秒数，也就是 Unix 时间戳。这个起点，不同平台是一致的，所以跨平台传递时间戳是安全的。
注意：localtime() 返回的指针指向一个静态缓冲区，不是线程安全的。多线程环境下请使用 localtime_r()（POSIX）或 localtime_s()（Windows）。
二、高精度计时：为什么需要它？
time.h 的精度是秒，但很多场景需要毫秒甚至微秒级的计时。比如：
- 性能基准测试：测量某段代码的执行时间
- 游戏循环：固定时间步长更新逻辑
- 音频处理：精确控制播放延迟
- 网络协议：RTT 测量、超时控制
这时候，就得请出平台特定的高精度计时器了。
三、Windows 平台：QueryPerformanceCounter
Windows 上，我习惯用 QueryPerformanceCounter 和 QueryPerformanceFrequency 这对函数。它们提供的是硬件级别的计时，精度通常在微秒级，甚至更高。
#include <windows.h>
double get_time_ms() {
LARGE_INTEGER freq, count;
QueryPerformanceFrequency(&freq);
QueryPerformanceCounter(&count);
return (double)count.QuadPart / freq.QuadPart * 1000.0;
}
int main() {
double start = get_time_ms();
// 模拟一些工作
Sleep(100);
double end = get_time_ms();
printf("耗时：%.3f ms\n", end - start);
return 0;
}这里有个坑：QueryPerformanceFrequency 返回的是每秒的计数次数，不同硬件可能不一样。我遇到过一台老机器，频率只有 1000 左右，精度就大打折扣。所以一定要先获取频率，再计算时间。
我的经验：在 Windows 上做性能测试时，建议先跑几轮“热身”，让 CPU 频率稳定下来。否则第一次调用 QueryPerformanceCounter 可能会因为缓存未命中而偏慢。
四、Linux/Unix 平台：clock_gettime
Linux 上，对应的函数是 clock_gettime。它支持多种时钟源，最常用的是 CLOCK_MONOTONIC——这个时钟不受系统时间调整的影响，适合测量时间间隔。
#include <time.h>
#include <stdio.h>
double get_time_ms() {
struct timespec ts;
clock_gettime(CLOCK_MONOTONIC, &ts);
return ts.tv_sec * 1000.0 + ts.tv_nsec / 1e6;
}
int main() {
double start = get_time_ms();
// 模拟一些工作
usleep(100000);
double end = get_time_ms();
printf("耗时：%.3f ms\n", end - start);
return 0;
}clock_gettime 的精度是纳秒级的，但实际分辨率取决于硬件和内核。大部分现代 Linux 系统上，精度能达到微秒级。
注意：CLOCK_REALTIME 可能会因为 NTP 同步或用户手动调整而跳跃，测量时间间隔时千万别用它。我见过有人用 CLOCK_REALTIME 做超时判断，结果系统时间被往回调了 1 秒，程序直接超时崩溃。
五、跨平台封装：统一接口
既然两个平台接口不同，那我们就封装一层。我个人习惯用条件编译来做，简单直接。
#ifdef _WIN32
#include <windows.h>
#else
#include <time.h>
#endif
typedef struct {
#ifdef _WIN32
LARGE_INTEGER start;
#else
struct timespec start;
#endif
} Timer;
void timer_start(Timer *t) {
#ifdef _WIN32
QueryPerformanceCounter(&t->start);
#else
clock_gettime(CLOCK_MONOTONIC, &t->start);
#endif
}
double timer_elapsed_ms(Timer *t) {
#ifdef _WIN32
LARGE_INTEGER freq, now;
QueryPerformanceFrequency(&freq);
QueryPerformanceCounter(&now);
return (double)(now.QuadPart - t->start.QuadPart) / freq.QuadPart * 1000.0;
#else
struct timespec now;
clock_gettime(CLOCK_MONOTONIC, &now);
double sec = now.tv_sec - t->start.tv_sec;
double nsec = now.tv_nsec - t->start.tv_nsec;
return sec * 1000.0 + nsec / 1e6;
#endif
}这样，上层代码只需要调用 timer_start() 和 timer_elapsed_ms()，底层细节完全隐藏。我在多个项目里用过这个封装，移植起来非常方便。
六、知识体系总览
下面这张图，把时间处理的核心脉络梳理清楚了：
七、避坑指南与最佳实践
做跨平台时间处理，有几个坑我反复踩过，今天一并说出来：
- 不要用 time() 做性能测试——精度太低，测出来的结果毫无意义。
- 不要混用不同时钟源——比如在 Windows 上用 QueryPerformanceCounter 开始计时，用 GetTickCount 结束，两个时钟的基准不同，结果会乱。
- 注意线程安全——localtime()、asctime() 这些函数内部有静态缓冲区，多线程下必须加锁或用带 _r 后缀的版本。
- 小心时间回跳——CLOCK_REALTIME 可能因为 NTP 调整而跳跃，测量间隔一定要用 CLOCK_MONOTONIC。
我的习惯：在项目里统一用一个全局的 Timer 结构体，所有模块都通过它来获取时间。这样一旦需要切换底层实现，只需要改一个地方。
好了，时间处理这块的核心内容就这些。从标准库到平台 API，再到跨平台封装，每一步都有它的道理。你想想看，如果当初我早点把这些理清楚，也不至于在项目里熬夜调试那个时间回跳的 bug 了。