Files.getLastModifiedTime() 是 Java 中用于获取文件最后修改时间的方法,它返回的是一个 FileTime 对象,表示文件的最后修改时间。你可以通过这个方法来检查文件最近一次被修改的时间点。示例代码(Java):import java.io.File; import java.nio.file.Files; import java.nio.file.Path; imp
时间:2026-05-12 21:54:54 330浏览 收藏
本文深入解析了 Java 中 Files.getLastModifiedTime() 方法的核心用法与常见陷阱:它返回高精度的 FileTime 对象(基于纳秒级纪元时间),而非简单的 long 或 Instant,必须通过 toInstant()、toMillis() 等显式转换才能安全使用;同时重点揭示了返回 1970-01-01 时间或抛出异常的真实原因——往往源于文件系统限制(如 FAT32、NFS、只读挂载、容器环境)或符号链接解析问题,并强调在时效性判断(如“5秒内是否修改”)中应避免粗暴比对毫秒值,而需借助 Instant 和 Duration 进行更精准、跨平台可靠的时序比较。

Files.getLastModifiedTime() 返回的是什么时间类型
Files.getLastModifiedTime() 返回的是 FileTime 类型,不是 long 毫秒值,也不是 Instant 或 LocalDateTime。直接打印会看到类似 2024-05-12T08:23:41.123Z 的字符串,但这是 FileTime.toString() 的格式化结果,底层是纳秒精度的纪元时间(epoch nanos)。
常见错误是试图用 fileTime.getTime()(这个方法根本不存在)或强制转型为 Date——FileTime 和 Date 无继承关系,必须显式转换:
- 转
Instant:调用fileTime.toInstant() - 转毫秒值:用
fileTime.toMillis()(注意:会截断纳秒,且对某些文件系统可能返回 -1,表示不支持或不可用) - 转
ZonedDateTime:先toInstant(),再.atZone(ZoneId.systemDefault())
为什么有时拿到的时间是 1970-01-01 或抛 UnsupportedOperationException
两种典型现象:FileTime.from(0)(即 1970-01-01T00:00Z)或抛出 UnsupportedOperationException,基本都指向同一个原因:目标文件不支持最后修改时间属性,或者 Java 无法从底层文件系统读取该元数据。
常见场景包括:
- 文件位于只读挂载点(如某些 Docker volume、NFS 共享、FAT32 分区)
- 使用了不支持时间戳的虚拟文件系统(如
MemoryFileSystem、某些测试 mock) - Java 运行在受限容器中,且宿主机文件系统权限/挂载选项屏蔽了
st_mtime - 路径指向的是符号链接,而你没设置
LinkOption.NOFOLLOW_LINKS,导致解析失败
安全做法是始终捕获 IOException 并检查返回值是否为 FileTime.from(0)(虽然不能 100% 代表无效,但结合异常更可靠)。
检查文件是否“刚被修改”时别直接比 long 毫秒
想判断一个文件是不是最近 5 秒内被改过?别写 Math.abs(System.currentTimeMillis() - fileTime.toMillis()) 。问题在于:toMillis() 会丢掉纳秒部分,且不同系统对“最后修改时间”的刷新粒度不同(例如 FAT32 是 2 秒,ext4 默认是纳秒但可能受挂载参数影响)。
更稳妥的方式是用 Instant 做比较:
try {
FileTime lastMod = Files.getLastModifiedTime(path);
Instant now = Instant.now();
Instant modTime = lastMod.toInstant();
if (Duration.between(modTime, now).getSeconds() <p>这样既保留精度,又避免手动算毫秒差带来的溢出或时区混淆风险。</p><h3>Windows 上要注意文件重命名和复制行为的影响</h3><p>在 Windows 中,单纯重命名一个文件(<code>Files.move(src, dst, StandardCopyOption.REPLACE_EXISTING)</code>)通常不会改变 <code>lastModifiedTime</code>;但用资源管理器拖拽复制,或通过 <code>Files.copy()</code> 创建新文件,则新文件的 <code>lastModifiedTime</code> 默认继承源文件——除非你显式调用 <code>Files.setAttribute(..., "basic:lastModifiedTime", ...)</code> 覆盖。</p><p>所以如果你依赖这个时间做“文件新鲜度”判断,要清楚:它反映的是内容最后一次写入磁盘的时间,不是文件被移动/重命名的时间,更不是程序调用 <code>write()</code> 的时刻(中间有缓冲)。真正关键的边界情况,往往藏在文件系统语义和 Java 封装之间的那层薄薄的抽象之下。</p><p>以上就是《Files.getLastModifiedTime() 是 Java 中用于获取文件最后修改时间的方法,它返回的是一个 FileTime 对象,表示文件的最后修改时间。你可以通过这个方法来检查文件最近一次被修改的时间点。示例代码(Java):import java.io.File;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.time.Instant;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
public class FileModificationCheck {
public static void main(String[] args) {
// 文件路径
Path path = Paths.get("example.txt");
try {
// 获取文件最后修改时间
FileTime lastModifiedTime = Files.getLastModifiedTime(path);
// 将 FileTime 转换为 Instant
Instant instant = lastModifiedTime.toInstant();
// 转换为本地时区时间
String formattedTime = instant.atZone(ZoneId.systemDefault())
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
System.out.println("文件最后修改时间: " + formattedTime);
} catch (Exception e) {
e.printStackTrace();
}
}
}说明:Files.getLastModifiedTime(Path path):获取指定路径下文件的最后修改时间。FileTime.toInstant():将 FileTime 转换为 Instant 对》的详细内容,更多关于的资料请关注golang学习网公众号!</p>
相关阅读
更多>
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
131 收藏
-
274 收藏
-
462 收藏
-
395 收藏
-
330 收藏
-
328 收藏
-
155 收藏
-
460 收藏
-
423 收藏
-
330 收藏
-
386 收藏
-
239 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习