C语言开发中如何设置含纳秒精度的文件时间戳

AI 小北

2026-8-26

根本原因

utime()接口及配套的struct utimbuf仅支持秒级时间精度，结构体的时间字段是只存秒数的time_t类型，没有预留亚秒（微秒、纳秒）的存储位，调用时会直接丢弃时间戳的小数部分，这就是123.213241的时间戳被截断为123.000000的原因。

实现方法

要保留纳秒级精度的时间戳，使用POSIX标准定义的纳秒级时间设置接口即可：

基于文件路径操作时用utimensat()
已经拿到目标文件打开的文件描述符时用futimens()

两个接口都通过struct timespec类型传递时间值，该结构包含tv_sec（秒数）和tv_nsec（纳秒数，取值范围0~999999999）两个字段，可以完整承接stat返回结果中st_atim（访问时间）、st_mtim（修改时间）的全精度时间值，不会丢失纳秒信息。

修正后的代码示例

#include <sys/stat.h>
#include <fcntl.h>

int sync_file_timestamp(const char* src_path, const char* dst_path) {
    struct stat src_stat;
    // 读取源文件元数据，必须检查返回值处理错误
    if (stat(src_path, &src_stat) != 0) {
        return -1;
    }

    // 时间数组固定长度为2：索引0存访问时间atime，索引1存修改时间mtime
    struct timespec new_ts[2];
    new_ts[0] = src_stat.st_atim; // 直接赋值完整timespec结构，完整保留纳秒
    new_ts[1] = src_stat.st_mtim;

    // 设置目标文件时间戳
    // AT_FDCWD表示目标路径是相对于当前进程工作目录的相对路径，无特殊需求flags参数填0即可
    if (utimensat(AT_FDCWD, dst_path, new_ts, 0) != 0) {
        return -1;
    }
    return 0;
}