Java 实例 – 获取文件修改时间：从基础到实战
在日常开发中，我们经常需要判断一个文件是否被修改过，比如在做日志监控、文件同步、自动化构建等场景时，获取文件的最后修改时间是一项基础但非常关键的功能。Java 本身提供了强大的文件操作能力，其中 java.nio.file 包中的 Files 类和 Path 接口，就是实现“获取文件修改时间”的标准方式。
今天，我们就来深入讲解一个非常实用的 Java 实例：如何获取文件的最后修改时间。无论你是初学者还是有一定经验的中级开发者，这篇文章都能帮你彻底掌握这一技能。
为什么需要获取文件修改时间？
想象一下你正在开发一个自动备份系统。系统需要判断某个配置文件是否被用户修改过，如果修改了，就自动备份一次。这时候，你不可能一直去读文件内容做对比，那样效率太低。更好的做法是：只比较文件的最后修改时间。
这就像你家的门锁，每次你出门前都检查门是否关好，但你不会每次都打开门看里面有没有东西。你只需要知道“门最后一次被关上的时间”就够了。文件的修改时间，就是这个“最后一次被关上的时间”。
在 Java 中，这个“时间”由 java.nio.file.attribute.FileTime 类表示，它能精确到纳秒级别，非常可靠。
使用 Files.getLastModifiedTime() 获取修改时间
Java 8 引入了新的 NIO.2（New I/O 2）API，其中 Files.getLastModifiedTime(Path) 方法是获取文件最后修改时间的核心工具。
我们先来看一个最简单的例子：
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
public class FileModificationTimeExample {
public static void main(String[] args) {
// 定义文件路径，注意路径中的反斜杠需要转义或使用斜杠
String filePath = "C:/projects/myfile.txt";
// 将路径转换为 Path 对象
Path path = Paths.get(filePath);
try {
// 获取文件的最后修改时间
// 这个方法返回的是 FileTime 类型，表示时间戳
java.nio.file.attribute.FileTime lastModifiedTime = Files.getLastModifiedTime(path);
// 将 FileTime 转换为 Instant（Java 8 时间类型）
Instant instant = lastModifiedTime.toInstant();
// 将 Instant 转换为本地时间（LocalDateTime）
LocalDateTime localDateTime = instant.atZone(ZoneId.systemDefault()).toLocalDateTime();
// 使用格式化器输出可读时间
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String formattedTime = localDateTime.format(formatter);
// 输出结果
System.out.println("文件路径: " + filePath);
System.out.println("最后修改时间: " + formattedTime);
} catch (IOException e) {
// 如果文件不存在或权限不足，会抛出 IOException
System.err.println("无法访问文件: " + e.getMessage());
}
}
}
代码逐行解析：
Paths.get(filePath)：将字符串路径转换为Path对象，这是 NIO.2 的核心接口。Files.getLastModifiedTime(path)：调用静态方法获取文件的最后修改时间，返回FileTime。toInstant()：将FileTime转为Instant，这是 Java 8 时间 API 的“时间点”表示。atZone(ZoneId.systemDefault())：将时间点转换为系统默认时区的时间。toLocalDateTime()：提取出日期和时间部分，便于展示。DateTimeFormatter.ofPattern(...)：定义时间格式，让输出更友好。try-catch：处理文件不存在、无权限等异常情况。
这个例子完整展示了从路径到可读时间的全过程。运行后，你会看到类似：
文件路径: C:/projects/myfile.txt
最后修改时间: 2024-04-05 14:32:18
处理异常情况：文件不存在怎么办？
在真实项目中，文件可能不存在，或者你没有读取权限。这时候，Files.getLastModifiedTime() 会抛出 IOException。
我们可以加入更细致的判断逻辑：
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
public class SafeFileTimeCheck {
public static void main(String[] args) {
String filePath = "D:/data/config.json";
Path path = Paths.get(filePath);
// 先判断文件是否存在
if (!Files.exists(path)) {
System.err.println("文件不存在: " + filePath);
return;
}
// 再判断是否是文件（而不是目录）
if (!Files.isRegularFile(path)) {
System.err.println("路径不是普通文件，可能是目录: " + filePath);
return;
}
// 检查是否有读取权限
if (!Files.isReadable(path)) {
System.err.println("没有权限读取该文件: " + filePath);
return;
}
try {
java.nio.file.attribute.FileTime fileTime = Files.getLastModifiedTime(path);
LocalDateTime lastModified = fileTime.toInstant()
.atZone(java.time.ZoneId.systemDefault())
.toLocalDateTime();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
System.out.println("文件 " + filePath + " 的最后修改时间是: " + lastModified.format(formatter));
} catch (IOException e) {
System.err.println("读取文件修改时间失败: " + e.getMessage());
}
}
}
关键点说明：
Files.exists(path)：判断路径是否存在。Files.isRegularFile(path)：确认路径指向的是普通文件，不是目录或链接。Files.isReadable(path)：检查是否有读权限。- 这些前置检查能有效避免程序崩溃，提升健壮性。
获取时间戳（毫秒级）用于比较
有时我们不需要人类可读的时间，而是需要一个数值时间戳，用于比较两个文件的修改先后顺序。
FileTime 提供了 toMillis() 方法，可以直接转换为毫秒。
long lastModifiedMillis = Files.getLastModifiedTime(path).toMillis();
System.out.println("最后修改时间戳（毫秒）: " + lastModifiedMillis);
这个数值可以轻松用于比较：
long time1 = Files.getLastModifiedTime(path1).toMillis();
long time2 = Files.getLastModifiedTime(path2).toMillis();
if (time1 > time2) {
System.out.println("文件1比文件2更新");
} else if (time1 < time2) {
System.out.println("文件2比文件1更新");
} else {
System.out.println("两个文件修改时间相同");
}
这在做文件同步、增量备份等场景中非常实用。
支持多种路径格式：绝对路径与相对路径
Java 的 Path 对象对路径格式非常友好，支持绝对路径和相对路径。
例如：
// 绝对路径（Windows）
Path path1 = Paths.get("C:/data/file.txt");
// 绝对路径（Unix/Linux/Mac）
Path path2 = Paths.get("/home/user/data/file.txt");
// 相对路径（相对于当前工作目录）
Path path3 = Paths.get("src/main/resources/config.json");
无论哪种路径，Files.getLastModifiedTime() 都能正确处理。只要路径合法，就能获取时间。
实际应用场景：文件监控工具
我们来做一个小工具，模拟一个“文件变更检测器”：
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
public class FileMonitor {
private final Path filePath;
private long lastCheckTime = 0;
public FileMonitor(String path) {
this.filePath = Paths.get(path);
}
public void checkForChanges() {
if (!Files.exists(filePath)) {
System.out.println("文件不存在: " + filePath);
return;
}
try {
long currentTime = Files.getLastModifiedTime(filePath).toMillis();
if (currentTime > lastCheckTime) {
LocalDateTime time = LocalDateTime.now();
System.out.println("【检测到变更】" + time.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
System.out.println("文件: " + filePath + " 已被修改");
lastCheckTime = currentTime;
} else {
System.out.println("文件未发生变化: " + filePath);
}
} catch (IOException e) {
System.err.println("无法读取文件: " + e.getMessage());
}
}
public static void main(String[] args) {
FileMonitor monitor = new FileMonitor("D:/logs/app.log");
// 模拟每隔 5 秒检查一次
while (true) {
monitor.checkForChanges();
try {
Thread.sleep(5000);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
break;
}
}
}
}
这个工具可以持续监控某个日志文件是否被写入。非常适合用于日志分析、实时告警等场景。
总结与建议
通过这篇文章，我们系统地学习了“Java 实例 – 获取文件修改时间”的完整流程。从最基础的方法调用，到异常处理、路径支持、时间格式转换，再到实际应用场景，层层递进，逻辑清晰。
关键点总结：
- 使用
Files.getLastModifiedTime(path)获取修改时间。 - 通过
toInstant()和atZone()转为可读时间。 - 前置检查
exists()、isRegularFile()、isReadable()，避免异常。 toMillis()用于时间比较，性能高。- 结合
Path对象，支持多种路径格式。 - 实际项目中可封装为监控工具，提升系统可靠性。
掌握这个技能后，你不仅能写出更健壮的文件处理程序，还能为后续的文件同步、版本控制、自动化运维打下坚实基础。
希望这篇文章能成为你学习 Java 文件操作的实用参考。动手试试吧，让代码真正“感知”到文件的变化。