linux下settimeofday需root权限且需确保有效uid为0，windows下setsystemtime需启用se_systemtime_name特权，跨平台校时应避免暴力设置而采用渐进式校正并记录详细错误信息。
Linux 下用 settimeofday 设置系统时间需要 root 权限
直接调用 settimeofday 修改系统时间在 Linux 上必然失败，除非进程拥有足够权限。这不是代码写得不对，而是内核强制的安全策略。
常见错误现象：settimeofday: Operation not permitted —— 即使你用 sudo 运行程序，也得确认实际有效 UID 是 0（geteuid() == 0）；如果程序被容器或 systemd service 封装，权限可能被进一步限制。
- 必须包含
<sys></sys>和<unistd.h></unistd.h> -
struct timeval的tv_sec是自 Unix epoch 起的秒数，tv_usec是微秒部分（不是毫秒） - 设置后不会自动同步硬件时钟（RTC），如需持久化，得额外调用
clock_settime(CLOCK_REALTIME, &ts)或执行hwclock --systohc - 避免用
stime()：已被弃用，精度低且不支持微秒
Windows 下 SetSystemTime 需要 SE_SYSTEMTIME_NAME 特权
Windows 不靠 UID/GID 管权限，而是基于“特权（Privilege）”模型。即使你是管理员组成员，SetSystemTime 默认仍被禁用 —— 必须显式启用 SE_SYSTEMTIME_NAME 特权才能成功。
常见错误现象：SetSystemTime: Access is denied，此时 GetLastError() 返回 5（拒绝访问），不是权限不足的模糊提示。
本文档主要讲述的是Android 操作系统的介绍；Android是基于Linux内核的操作系统，是Google公司在2007年11月5日公布的手机操作系统，早期由Google开发，后由开放手持设备联盟（Open Handset Alliance）开发。它采用了软件堆层（software stack，又名以软件叠层）的架构，主要分为三部分。底层Linux内核只提供基本功能；其他的应用软件则由各公司自行开发，部分程序以Java编写。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
- 调用前必须用
OpenProcessToken+LookupPrivilegeValue+AdjustTokenPrivileges启用特权 -
SYSTEMTIME结构中wMilliseconds字段只到毫秒级，无法设纳秒 - 该 API 设置的是本地时间，不自动处理时区转换；若传入 UTC 时间，应先调用
TzSpecificLocalTimeToSystemTime - 不要混用
SetLocalTime：它会按当前时区解释输入值，容易引发时区误判
跨平台同步逻辑不能只靠“当前时间差”做判断
单纯比对两个时间戳（比如 GPS 时间 vs time(nullptr)）来决定是否校时，会忽略时钟漂移趋势和瞬时异常。一次偏差 2 秒，可能是 NTP 正在后台平滑调整，也可能是 GPS 模块刚上电未收敛。
真实场景中，连续多次采样、带滑动窗口过滤、结合单调时钟估算 drift rate，才构成可靠同步策略。
- 用
std::chrono::steady_clock::now()记录每次读取时间的“相对时刻”，避免system_clock回跳干扰 drift 计算 - GPS 时间通常含周数+秒数，转为 Unix 时间需手动加偏移（如 GPS epoch 是 1980-01-06 00:00:00 UTC，比 Unix epoch 早 315964800 秒）
- Linux 下建议用
adjtimex()做渐进式校正，而非暴力settimeofday，减少对其他进程 time() 调用的影响 - Windows 可调用
SetThreadExecutionState防止休眠打断校时流程，尤其在嵌入式或车载场景下
同步失败时别静默吞掉错误
时间设置失败往往意味着更深层问题：权限缺失、NTP 正在运行冲突、硬件时钟电池没电、甚至 SELinux/AppArmor 限制。日志里只写“sync failed”等于放弃诊断线索。
至少记录三类信息：原始时间源值（如 GPS 周+秒）、目标系统时间、errno 或 GetLastError() 值。
- Linux 下检查
/var/log/syslog或dmesg是否有 “clock: time warp detected” 类提示 - Windows 下可用
wevtutil qe System /q:"*[System[(EventID=41)]]"查看时钟相关事件日志 - 避免在信号处理函数里调用
settimeofday：它不是 async-signal-safe 函数，可能死锁 - 如果校时是周期性任务，失败后应指数退避重试，而不是固定间隔狂刷
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
