一文分享Java日期解析的完整方案(覆盖50+种格式自动识别)
作者：pan-common
写后端接口，日期解析是个躲不过去的坎。
前端传 "2024-01-15"，Excel 导出的文件里是 "2024/01/15"，财务系统对接传的是 "20240115"，移动端有时候还扔一个 "2024年1月15日" 过来。更烦人的是，有时候同一个接口，同一个参数，上游不同调用方传不同的格式——你得一个个兼容。
网上搜 “Java 日期解析”，清一色教你这么写：
// 经典做法：写一堆 try-catch
public static Date parse(String dateStr) {
String[] patterns = {
"yyyy-MM-dd HH:mm:ss", "yyyy-MM-dd", "yyyy/MM/dd HH:mm:ss",
"yyyy/MM/dd", "yyyyMMddHHmmss", "yyyyMMdd",
// ... 写几十个
};
for (String pattern : patterns) {
try {
return DateUtil.parse(dateStr, pattern);
} catch (Exception e) { }
}
throw new IllegalArgumentException("无法解析: " + dateStr);
}
代码冗长不说，性能也有问题——解析 "2024年1月15日" 要先试前面 40 多个常规格式，每个都走一遍 DateTimeFormatter.parse，失败、抛异常、catch 吞掉，再试下一个。
DateParserUtils 换了个思路：先看字符串有什么分隔符，直接跳到对应格式组，不遍历。
引入依赖
<!-- Spring Boot 2.x --> <dependency> <groupId>com.gitee.apanlh</groupId> <artifactId>apanlh-common</artifactId> <version>2.0.6</version> </dependency>
Spring Boot 3.x 项目：
<dependency> <groupId>com.gitee.apanlh</groupId> <artifactId>apanlh-common</artifactId> <version>3.0.6</version> </dependency>
JDK 8+ 可用，零强制依赖。
自动识别，不传 pattern
// 横线分隔
DateParserUtils.toLocalDateTime("2024-01-15 10:30:45");
// → 2024-01-15T10:30:45
// 斜杠分隔
DateParserUtils.toLocalDateTime("2024/01/15 10:30:45");
// → 2024-01-15T10:30:45
// 点分隔
DateParserUtils.toLocalDateTime("2024.01.15 10:30:45");
// → 2024-01-15T10:30:45
// 紧凑格式（无分隔符）
DateParserUtils.toLocalDateTime("20240115103045");
// → 2024-01-15T10:30:45
// 中文格式
DateParserUtils.toLocalDateTime("2024年1月15日 10时30分45秒");
// → 2024-01-15T10:30:45
// ISO 格式（带 T 和纳秒）
DateParserUtils.toLocalDateTime("2024-01-15T10:30:45.123456789");
// → 2024-01-15T10:30:45.123456789
一个 toLocalDateTime(String) 方法不传 pattern，底层自动识别不会在无效格式上浪费时间。
纯日期、纯时间也一样
// 日期解析 —— 同样自动识别
DateParserUtils.toLocalDate("2024-01-15"); // 横线
DateParserUtils.toLocalDate("2024/01/15"); // 斜杠
DateParserUtils.toLocalDate("2024.01.15"); // 点
DateParserUtils.toLocalDate("2024_01_15"); // 下划线
DateParserUtils.toLocalDate("20240115"); // 紧凑
DateParserUtils.toLocalDate("2024年1月15日"); // 中文
// 时间解析
DateParserUtils.toLocalTime("10:30:45"); // 冒号
DateParserUtils.toLocalTime("10.30.45"); // 点
DateParserUtils.toLocalTime("10时30分45秒"); // 中文
DateParserUtils.toLocalTime("103045"); // 紧凑
日期额外支持下划线分隔，时间支持冒号、点、中文、紧凑四种格式。
tryTo* 降级：类型不兼容时自动处理
实际开发经常遇到：上游传了 "2024-01-15 14:30:45"，但你的业务只需要日期。用 toLocalDate 解析会失败，因为格式组里有时间部分。
tryToLocalDate 一行搞定：
// 传了日期时间字符串，但只需要日期 → 自动截取日期部分
DateParserUtils.tryToLocalDate("2024-01-15 14:30:45");
// → 2024-01-15
// 传了纯日期，但需要日期时间 → 自动补当前时间
DateParserUtils.tryToLocalDateTime("2024-01-15");
// → 2024-01-15T14:30:45（当前系统时间）
// 传了日期时间，只需要时间部分
DateParserUtils.tryToLocalTime("2024-01-15 14:30:45");
// → 14:30:45
注意：tryTo 不是"不抛异常"——它只是在类型不匹配时做了降级尝试。降级也失败的话，原始异常还是会抛的。
实际开发中高频使用的方法
时间戳自动识别
前端有时候传秒级 1705305045，有时候传毫秒级 1705305045000。这个方法自动判断：
DateParserUtils.toLocalDateTime(1705305045L); // 秒级 → 正确解析 DateParserUtils.toLocalDateTime(1705305045000L); // 毫秒级 → 正确解析
大于等于 1_000_000_000_000L 当毫秒处理，否则当秒处理。
Date 与 LocalDateTime 互转
// Date → LocalDateTime DateParserUtils.toLocalDateTime(new Date()); // LocalDateTime → Date DateParserUtils.toDate(LocalDateTime.now()); // LocalDate → Date DateParserUtils.toDate(LocalDate.now()); // LocalTime → Date（自动用当天日期组合） DateParserUtils.toDate(LocalTime.of(14, 30));
字符串 → 秒/毫秒时间戳
DateParserUtils.toTimestamp("2024-01-15 14:30:45"); // 秒
DateParserUtils.toTimestampMillis("2024-01-15 14:30:45"); // 毫秒
自定义格式解析
不走自动识别，直接用指定格式：
DateParserUtils.toLocalDateTime("2024-01-15 14:30:45", "yyyy-MM-dd HH:mm:ss");
// 用 DateTimeFormatter
DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
DateParserUtils.toLocalDateTime("2024-01-15 14:30:45", fmt);
全局注册自定义格式
内置的 50+ 格式覆盖了绝大部分场景，但如果你们的系统有特殊格式（比如某些老旧系统用 | 分隔），可以注册全局格式：
// 应用启动时注册一次，后续所有 DateParserUtils 调用都生效
DateParserUtils.addCustomLocalDateTimeFormats(
DateTimeFormatter.ofPattern("yyyy|MM|dd HH|mm|ss")
);
// 之后直接用
DateParserUtils.toLocalDateTime("2024|01|15 14|30|45");
// → 2024-01-15T14:30:45
自定义格式优先级最高（代码里最先判断），底层用 ConcurrentHashMap.newKeySet() 存储，线程安全。分别有 addCustomLocalDateTimeFormats、addCustomLocalDateFormats、addCustomLocalTimeFormats 三个方法。
DateTimeFormatter 缓存
内部所有 DateTimeFormatter 都通过缓存获取，预初始化了 17 种常用格式，后续调用直接命中缓存，减少 pattern 字符串的 hash 比较开销：
public static DateTimeFormatter getFormat(String format) {
return DATE_FORMAT_CACHE.get(format, () -> DateTimeFormatter.ofPattern(format));
}
性能对比
测试环境：JMH 1.37 / JDK 25
Benchmark pan-common Hutool 5.8.44 倍数
────────────────────────────────────────────────────────────────────────────
日期解析 "2026-05-31 14:30:45" 5,076 ops/ms 566 ops/ms 9.0x
日期解析 "2026/05/31 14:30:45" 5,021 ops/ms 543 ops/ms 9.2x
日期解析 "2026年5月31日 14时30分45秒" 5,264 ops/ms 269 ops/ms 19.6x
日期解析 "20260531143045" 4,226 ops/ms 3,025 ops/ms 1.4x
不适合的场景
说清楚它不做的事情：
- 不处理时区偏移。核心解析用系统默认时区
ZoneId.systemDefault()。多时区环境要注意。 - 纯数字时间戳字符串不认。如果前端传
"1705305045000"字符串，toLocalDateTime(String)会当紧凑日期格式去解析。得自己先转成long再调用。 tryToLocalTime对纯日期字符串不生效。"2024-01-15"传进去不会变成00:00:00，因为日期组和时间组的分隔符不重叠。
总结
DateParserUtils 的核心价值就是一件事：一个方法覆盖 50+ 种日期格式，不用传 pattern，自动识别。分隔符路由的思路不复杂，但实际用起来确实省事——不用再写那一堆 try-catch 了。
到此这篇关于一文分享Java日期解析的完整方案(覆盖50+种格式自动识别)的文章就介绍到这了,更多相关Java日期解析内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！