Java 实用时间工具类：DateUtils 与 DurationFormatUtils

前言

        在 Java 项目中，处理日期时间相关的操作极为常见。Apache Commons Lang 提供了两个非常实用的时间工具类：DateUtils 和 DurationFormatUtils，它们分别负责简化日期处理和格式化时间间隔，帮助开发者更高效地进行时间操作。

---

一、引入依赖

Maven：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.12.0</version>
</dependency>

---

二、DateUtils 常用功能

org.apache.commons.lang3.time.DateUtils 提供了许多关于 Date 的便捷方法。

1. 日期加减

Date tomorrow = DateUtils.addDays(new Date(), 1);
Date nextHour = DateUtils.addHours(new Date(), 1);

2. 设置时间单位

Date truncatedDate = DateUtils.truncate(new Date(), Calendar.DAY_OF_MONTH);

3. 日期比较

boolean isSameDay = DateUtils.isSameDay(date1, date2);

4. 清除时间部分

Date dateOnly = DateUtils.truncate(new Date(), Calendar.DATE);

5. 日期舍入与舍弃

Date roundToNearestHour = DateUtils.round(new Date(), Calendar.HOUR);

---

三、DurationFormatUtils 常用功能

org.apache.commons.lang3.time.DurationFormatUtils 用于格式化毫秒时间间隔。

1. 格式化毫秒为字符串

String duration = DurationFormatUtils.formatDuration(1234567L, "HH:mm:ss.SSS");

输出: 00:20:34.567

2. 格式化时间段（开始 - 结束）

String period = DurationFormatUtils.formatPeriod(start.getTime(), end.getTime(), "d'd' H'h' m'm' s's'");

输出: 0d 3h 5m 10s

---

四、常见应用场景

• 日志记录：记录接口耗时、方法执行时间。

• 任务调度：设置周期、计算下一次运行时间。

• 数据可视化：展示时间段、人类可读的持续时间。

• 日期归一化：进行按天、小时等单位进行聚合处理。

---

五、与原生 API 对比优势

功能	原生 API	Commons Lang
日期加减	Calendar.set()	addXxx() 方法简洁
格式化持续时间	自定义逻辑实现	formatDuration() 一行搞定
舍入、截断	无	round()/truncate() 非常实用

---

六、注意事项

1. 这两个类依赖于传统的 Date 和 Calendar，并不支持 Java 8 的 java.time API。

2. 如果项目中已全面使用 java.time，可以使用 Duration, LocalDateTime, ChronoUnit 等替代方案。

3. 对于毫秒级别的精度控制，DurationFormatUtils 格式化非常适合展示用，但不建议用于时间精度敏感的业务逻辑。

---

七、总结

    DateUtils 和 DurationFormatUtils 是 Apache Commons Lang 中两个经典的时间工具类，帮助我们更简单、安全、直观地处理日期与时间间隔。在传统 Java 时间处理中非常有用，特别是在与第三方老旧系统集成、或需要快速实现时间处理逻辑的场景中表现出色。

        掌握它们，你的时间处理代码将更加简洁优雅，开发效率也会显著提升。