Java毫秒转友好时间，Apache Commons Lang教程

在Java开发中，我们经常需要处理时间数据，尤其是在表示持续时间（duration）时。原始的毫秒值（long类型）对于用户来说并不直观，例如3600000毫秒远不如“1小时”来得清晰。传统的做法是手动计算天、小时、分钟、秒，然后通过字符串拼接来构建可读的持续时间字符串。这种方法不仅代码量大，而且需要处理各种边界情况，如零值单位的省略（例如，“2小时0分钟0秒”简化为“2小时”），这使得代码变得复杂且易出错。

引入Apache Commons Lang的DurationFormatUtils

为了解决这一痛点，我们可以借助Apache Commons Lang库中的DurationFormatUtils工具类。该工具提供了一系列方法来格式化持续时间，其中formatDurationWords方法尤其适用于生成自然语言描述的持续时间字符串，并且能够智能地处理前导和尾随零元素的抑制。

1. 添加依赖

首先，你需要在项目的构建配置中添加Apache Commons Lang的依赖。如果你使用Maven，请在pom.xml中添加：

    org.apache.commons
    commons-lang3
    3.12.0 

如果你使用Gradle，请在build.gradle中添加：

implementation 'org.apache.commons:commons-lang3:3.12.0' // 请使用最新稳定版本

2. 使用 formatDurationWords 方法

DurationFormatUtils.formatDurationWords 方法的签名如下：

public static String formatDurationWords(long durationMillis, boolean suppressLeadingZeroElements, boolean suppressTrailingZeroElements)

参数说明：

• durationMillis: 需要格式化的持续时间，以毫秒为单位的long值。
• suppressLeadingZeroElements: 如果为true，则会抑制前导的零值单位。例如，如果持续时间不足一天，则不会显示“0天”。
• suppressTrailingZeroElements: 如果为true，则会抑制尾随的零值单位。例如，如果持续时间刚好是2小时，则不会显示“0分钟0秒”。

示例代码：

下面通过几个例子展示如何使用formatDurationWords方法：

import org.apache.commons.lang3.time.DurationFormatUtils;

public class DurationFormatter {

    public static void main(String[] args) {
        // 1. 刚好是2小时
        long duration1 = 2 * 60 * 60 * 1000L; // 7200000 毫秒
        String result1 = DurationFormatUtils.formatDurationWords(duration1, true, true);
        System.out.println("2小时: " + result1); // 输出: 2 hours

        // 2. 5分钟2秒
        long duration2 = (5 * 60 + 2) * 1000L; // 302000 毫秒
        String result2 = DurationFormatUtils.formatDurationWords(duration2, true, true);
        System.out.println("5分钟2秒: " + result2); // 输出: 5 minutes 2 seconds

        // 3. 1天3小时15分钟
        long duration3 = (24 * 60 * 60 + 3 * 60 * 60 + 15 * 60) * 1000L;
        String result3 = DurationFormatUtils.formatDurationWords(duration3, true, true);
        System.out.println("1天3小时15分钟: " + result3); // 输出: 1 day 3 hours 15 minutes

        // 4. 不足1秒
        long duration4 = 500L; // 500毫秒
        String result4 = DurationFormatUtils.formatDurationWords(duration4, true, true);
        System.out.println("不足1秒: " + result4); // 输出: 0 seconds (因为最短单位是秒，不足1秒会显示0秒)

        // 5. 持续时间很长
        long duration5 = (365 * 24 * 60 * 60 + 10 * 60 * 60 + 30 * 60 + 45) * 1000L; // 大约1年10小时30分钟45秒
        String result5 = DurationFormatUtils.formatDurationWords(duration5, true, true);
        System.out.println("长时间: " + result5); // 输出: 365 days 10 hours 30 minutes 45 seconds
    }
}

输出结果：

2小时: 2 hours
5分钟2秒: 5 minutes 2 seconds
1天3小时15分钟: 1 day 3 hours 15 minutes
不足1秒: 0 seconds
长时间: 365 days 10 hours 30 minutes 45 seconds

从输出可以看出，formatDurationWords方法自动处理了单位的转换和零元素的抑制，使得输出结果非常符合人类阅读习惯。它默认使用的单位是天、小时、分钟和秒。

3. 注意事项与总结

• 单位精度: formatDurationWords方法默认的最小单位是秒。如果你的持续时间非常短（例如只有几百毫秒），它会显示为“0 seconds”。如果你需要更细粒度的显示（如毫秒），则需要使用formatDuration方法并自定义格式，或者手动处理。
• 语言环境: formatDurationWords生成的字符串是英文的（如"days", "hours", "minutes", "seconds"）。如果你的应用需要支持多语言环境下的持续时间显示，你可能需要结合国际化（i18n）资源文件来构建相应的本地化字符串，或者考虑其他更专业的国际化时间库。
• 灵活性: DurationFormatUtils还提供了其他方法，例如formatDuration(long durationMillis, String format)，允许你通过自定义格式字符串（如"HH:mm:ss"）来精确控制输出格式。然而，对于生成自然语言描述，formatDurationWords通常是最佳选择。

通过采用Apache Commons Lang的DurationFormatUtils.formatDurationWords方法，我们可以轻松地将原始的毫秒值转换为用户友好的时间字符串，显著简化了代码逻辑，提高了开发效率和应用的用户体验。这是一个在Java项目中处理持续时间格式化问题的强大且简洁的解决方案。