
用 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。
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,含纳秒字段;WindowsFILETIME是 100ns 单位,精度更高 - Windows 上
GetFileTime返回的是 UTC 时间,FileTimeToSystemTime自动转成本地时区;POSIXlocaltime也做时区转换,但要注意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()),还得注明单位——否则半年后自己都看不懂那是秒还是纳秒。











