一文分享Java日期解析的完整方案(覆盖50+种格式自动识别)

 更新时间:2026年06月02日 08:49:45   作者:pan-common  
写后端接口,日期解析是个躲不过去的坎,本文主要和大家分享一下Java中日期解析的完整方案,一个方法可以覆盖50+种格式自动识别,希望对大家有所帮助

写后端接口,日期解析是个躲不过去的坎。

前端传 "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() 存储,线程安全。分别有 addCustomLocalDateTimeFormatsaddCustomLocalDateFormatsaddCustomLocalTimeFormats 三个方法。

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日期解析内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 如何解决java:错误:无效的源发行版:16

    如何解决java:错误:无效的源发行版:16

    这篇文章主要介绍了如何解决java:错误: 无效的源发行版:16问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-04-04
  • JAVA熔断和降级真实关系的图文详解

    JAVA熔断和降级真实关系的图文详解

    这篇文章主要介绍了Java熔断和降级的关系,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-09-09
  • Java实现八种排序算法详细代码举例

    Java实现八种排序算法详细代码举例

    排序问题一直是程序员工作与面试的重点,今天特意整理研究下与大家共勉!这篇文章主要介绍了Java实现八种排序算法的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-10-10
  • Springcould多模块搭建Eureka服务器端口过程详解

    Springcould多模块搭建Eureka服务器端口过程详解

    这篇文章主要介绍了Springcould多模块搭建Eureka服务器端口过程详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-11-11
  • 详解java封装实现Excel建表读写操作

    详解java封装实现Excel建表读写操作

    这篇文章给大家分享了java封装实现Excel建表读写操作的相关知识点内容,有需要的朋友们可以学习下。
    2018-08-08
  • Java 如何将前端传来的数字转化为日期

    Java 如何将前端传来的数字转化为日期

    这篇文章主要介绍了Java 如何将前端传来的数字转化为日期,本文通过示例代码给大家介绍的非常详细,需要的朋友可以参考下
    2023-06-06
  • mybatis中注解映射SQL示例代码

    mybatis中注解映射SQL示例代码

    这篇文章主要给大家介绍了关于mybatis中注解映射SQL的相关资料,文中给出了详细的示例代码供大家参考学习,对大家的学习或者共组具有一定的参考学习价值,需要的朋友们下面跟着小编来一起学习学习吧。
    2017-08-08
  • SpringBoot任意版本集成Swagger各种版本的操作指南

    SpringBoot任意版本集成Swagger各种版本的操作指南

    在学习Swagger生成API文档的时候经常会遇到问题,而目前市面上大部分技术分享者的SpringBoot版本并没和我们的同步,导致一些一模一样的代码,在我们的项目上却无法使用,这是一个经常性的问题,本文章就旨在和大家搞定SpringBoot任意版本集成Swagger各种版本
    2024-07-07
  • SpringBoot整合Kafka工具类的详细代码

    SpringBoot整合Kafka工具类的详细代码

    Kafka是一种高吞吐量的分布式发布订阅消息系统,它可以处理消费者在网站中的所有动作流数据,这篇文章主要介绍了SpringBoot整合Kafka工具类的代码详解,需要的朋友可以参考下
    2022-09-09
  • SpringBoot2使用Jetty容器操作(替换默认Tomcat)

    SpringBoot2使用Jetty容器操作(替换默认Tomcat)

    这篇文章主要介绍了SpringBoot2使用Jetty容器操作(替换默认Tomcat),具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-10-10

最新评论