登录
首页 >  文章 >  java教程

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() 返回的是什么时间类型

Files.getLastModifiedTime() 返回的是 FileTime 类型,不是 long 毫秒值,也不是 InstantLocalDateTime。直接打印会看到类似 2024-05-12T08:23:41.123Z 的字符串,但这是 FileTime.toString() 的格式化结果,底层是纳秒精度的纪元时间(epoch nanos)。

常见错误是试图用 fileTime.getTime()(这个方法根本不存在)或强制转型为 Date——FileTimeDate 无继承关系,必须显式转换:

  • 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>
资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>