c++中如何获取文件最后修改时间_c++ filesystem库时间操作【详解】

2026-01-19

c++中如何获取文件最后修改时间_c++ filesystem库时间操作【详解】

c++kquote>C++17起推荐用std::filesystem::last_write_time获取文件修改时间，需转为time_t再格式化输出，注意旧编译器bug及异常处理。

c++中如何获取文件最后修改时间_c++ filesystem库时间操作【详解】

用 `std::filesystem::last_write_time` 获取文件最后修改时间

这是 C++17 起最标准、最可靠的方式，不需要依赖平台 API 或第三方库。它返回一个 std::filesystem::file_time_type，本质是高精度时钟点（通常基于系统启动或纪元），不能直接当秒数或字符串用。

常见错误是拿到 file_time_type 后直接输出或比较，结果为 0 或乱码——因为它和 std::chrono::system_clock 不兼容，必须转换。

必须先用 std::filesystem::file_time_type::clock::to_time_t() 转成 time_t 才能进 localtime/strftime
某些旧版 libstdc++（如 GCC 8.3 之前）对 last_write_time 的实现有 bug，返回值恒为 epoch，建议升级到 GCC 9+ 或 Clang 7+
路径不存在或无权限时会抛出 std::filesystem::filesystem_error，务必捕获

try {
    auto ftime = std::filesystem::last_write_time("data.txt");
    auto cftime = decltype(ftime)::clock::to_time_t(ftime);
    std::cout << std::put_time(std::localtime(&cftime), "%Y-%m-%d %H:%M:%S") << "/n";
} catch (const std::filesystem::filesystem_error& e) {
    std::cerr << "Failed to get mtime: " << e.what() << "/n";
}

为什么不能直接用 `std::chrono::system_clock::from_time_t` 转换

std::filesystem::file_time_type 和 std::chrono::system_clock 是两个独立时钟，它们的纪元（epoch）和步长可能不同。强行用 system_clock::from_time_t 转会导致时间偏移几小时甚至几十年。

典型现象：明明文件是今天修改的，输出却是 1970-01-01 或 2038 年以后。

立即学习“C++免费学习笔记（深入）”；

正确做法是只用 file_time_type::clock::to_time_t → time_t → localtime
若需转成 system_clock::time_point，得查系统文档确认是否支持（POSIX 系统通常可近似转换，但非标准）
Windows 上 file_time_type 基于 FILETIME（100ns 单位，纪元为 1601-01-01），Linux 上多基于 CLOCK_REALTIME 或 inode ctime，跨平台不可比

替代方案：POSIX `stat()` 和 Windows `GetFileTime()`

如果项目不能用 C++17，或需要更高精度（如纳秒级）、更细粒度控制（如获取 birth time），就得回退到系统 API。

绘ai

ai绘图提示词免费分享

下载

POSIX 示例（Linux/macOS）：

struct stat st;
if (stat("data.txt", &st) == 0) {
    char buf[64];
    strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", localtime(&st.st_mtim.tv_sec));
    std::cout << buf << "." << st.st_mtim.tv_nsec / 1000000 << "s/n"; // 毫秒级
}

Windows 示例（需 #include ）：

HANDLE h = CreateFileA("data.txt", GENERIC_READ, FILE_SHARE_READ,
                       nullptr, OPEN_EXISTING, 0, nullptr);
FILETIME ft;
if (h != INVALID_HANDLE_VALUE && GetFileTime(h, nullptr, nullptr, &ft)) {
    SYSTEMTIME st;
    FileTimeToSystemTime(&ft, &st);
    printf("%04d-%02d-%02d %02d:%02d:%02d/n",
           st.wYear, st.wMonth, st.wDay,
           st.wHour, st.wMinute, st.wSecond);
}
CloseHandle(h);

POSIX stat 的 st_mtim 是 timespec，含纳秒字段；Windows FILETIME 是 100ns 单位，精度更高
Windows 上 GetFileTime 返回的是 UTC 时间，FileTimeToSystemTime 自动转成本地时区；POSIX localtime 也做时区转换，但要注意 tzset() 是否生效
这两个 API 都不抛异常，靠返回值判断失败，容易被忽略错误分支

注意时区与跨平台一致性

所有方法获取的“最后修改时间”本质上都是操作系统记录的 UTC 时间戳，但显示时是否转本地时区，取决于你用的转换函数（localtime vs gmtime）。同一份代码在不同时区机器上输出不同，不是 bug，是预期行为。

若需固定时区（如 always UTC），统一用 gmtime + std::put_time
Linux 上 ext4 默认不存 birth time，statx() 可能返回 -1；macOS HFS+ 支持，但 C++ filesystem 库不暴露该字段
容器环境（如 Docker）中，宿主机和容器时区不一致时，localtime 行为可能意外，建议显式设置 TZ 环境变量或硬编码 UTC

真正麻烦的不是怎么取时间，而是后续怎么比、怎么存、要不要序列化。比如把 file_time_type 存进数据库，就得先转成 int64_t（用 time_since_epoch().count()），还得注明单位——否则半年后自己都看不懂那是秒还是纳秒。

https://www.php.cn/faq/2002703.html