本文介绍在Java中如何将长整型毫秒值转换为易于理解的时间字符串，例如“5分钟2秒”或“2小时”。针对传统方法需手动拼接的痛点，推荐使用apache Commons Lang库中的DurationformatUtils.formatDurationwords方法，它能简洁高效地生成诸如“X天Y小时Z分钟”格式的字符串，避免了复杂的逻辑判断和字符串操作，极大地提升了代码的可读性和开发效率。
在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中添加：
<dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-lang3</artifactId> <version>3.12.0</version> <!-- 请使用最新稳定版本 --> </dependency>
如果你使用gradle，请在build.gradle中添加：
implementation 'org.apache.commons:commons-lang3:3.12.0' // 请使用最新稳定版本
2. 使用 formatDurationWords 方法
DurationFormatUtils.formatDurationWords 方法的签名如下：
立即学习“Java免费学习笔记（深入）”；
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项目中处理持续时间格式化问题的强大且简洁的解决方案。
暂无评论内容