Java日期解析需按API类型捕获对应异常：SimpleDateFormat抛ParseException（检查型），须try-catch并打印输入与格式；DateTimeFormatter抛DateTimeParseException（运行时），建议捕获并利用getErrorIndex()等信息；推荐封装为返回Optional的安全方法，避免null且提升健壮性。
在 Java 中解析日期时遇到格式错误，最常见的是抛出 ParseException（属于检查型异常）或 DateTimeParseException（Java 8+ 的非检查型异常），关键是要根据使用的日期 API 正确捕获对应异常。
使用 SimpleDateFormat 时捕获 ParseException
SimpleDateFormat 是旧版 API，parse() 方法声明抛出 java.text.ParseException，必须显式处理：
- 用
try-catch捕获ParseException，不能只捕获其父类Exception（虽可行但不精准） - 建议同时打印原始输入和期望格式，便于排查问题
- 注意：
SimpleDateFormat不是线程安全的，多线程环境下需避免共享实例
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
sdf.setLenient(false); // 关闭宽松解析，避免 2023-02-30 被转成 2023-03-02
try {
Date date = sdf.parse("2023-13-01"); // 格式错误 → ParseException
} catch (ParseException e) {
System.err.println("日期解析失败：" + e.getMessage());
System.err.println("输入值：'2023-13-01'，期望格式：yyyy-MM-dd");
}
使用 DateTimeFormatter（Java 8+）时捕获 DateTimeParseException
LocalDate.parse()、LocalDateTime.parse() 等方法内部使用 DateTimeFormatter，出错时抛出运行时异常 DateTimeParseException，无需强制 try-catch，但强烈建议捕获：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 该异常包含详细信息：错误位置（
getErrorIndex()）、未解析文本（getParsedString()） - 可结合
DateTimeFormatter.ofPattern("...").withResolverStyle(ResolverStyle.STRICT)加强校验 - 不推荐依赖默认宽松模式，例如 "2023-02-30" 在 STRICT 下直接报错，LENIENT 下可能静默调整
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd")
.withResolverStyle(ResolverStyle.STRICT);
try {
LocalDate date = LocalDate.parse("2023-02-30", formatter);
} catch (DateTimeParseException e) {
System.err.println("解析失败，位置：" + e.getErrorIndex());
System.err.println("输入内容：" + e.getParsedString());
}
统一处理策略：封装工具方法 + 返回 Optional
为提升代码健壮性和可读性，可将日期解析封装为安全方法，避免上层重复写 try-catch：
立即学习“Java免费学习笔记（深入）”；
- 返回
Optional<LocalDate>或Optional<Date>，让调用方决定如何处理空值 - 对无效输入返回
Optional.empty()，不抛异常，也不返回 null - 日志记录异常细节（如需审计），但不打断主流程
public static Optional<LocalDate> parseSafe(String text, String pattern) {
try {
return Optional.of(LocalDate.parse(text, DateTimeFormatter.ofPattern(pattern)
.withResolverStyle(ResolverStyle.STRICT)));
} catch (DateTimeParseException e) {
logger.warn("日期解析失败: '{}'（格式: {}）", text, pattern, e);
return Optional.empty();
}
}
// 使用
Optional<LocalDate> result = parseSafe("2023/01/01", "yyyy-MM-dd"); // empty
result.ifPresentOrElse(
d -> System.out.println("成功：" + d),
() -> System.out.println("格式不匹配，跳过")
);
常见误区提醒
实际开发中容易忽略的细节：
-
时区陷阱：用
SimpleDateFormat解析无时区时间却设了时区（如sdf.setTimeZone(TimeZone.getTimeZone("UTC"))），可能导致结果偏移 - 模式字母大小写敏感：`MM` 是月份，`mm` 是分钟；`YYYY`（基于周的年）≠ `yyyy`（日历年），混用会导致 2023-12-31 解析成 2024
-
中文环境下的 Locale 问题：若日期含中文（如“2023年1月1日”），需指定
Locale.CHINA构造 formatter，否则可能解析失败
