HumanizeDuration.js 时间格式化库的零值显示问题探讨

在时间格式化处理中，开发者经常需要将毫秒数转换为人类可读的格式。HumanizeDuration.js 是一个流行的 JavaScript 库，专门用于这种转换场景。然而，该库在处理零值单位时采用了自动跳过的策略，这在某些特定业务场景下可能不符合需求。

默认行为分析

HumanizeDuration.js 的默认行为是跳过所有零值的时间单位。例如：

• 3分2秒 → "3分钟2秒"
• 3分0秒 → "3分钟"（自动跳过0秒）
• 2分59秒 → "2分钟59秒"

这种设计符合大多数日常场景的阅读习惯，但在需要严格显示所有时间单位的场景（如倒计时显示、科学实验记录等）会产生问题。

技术实现原理

该库的核心算法基于以下逻辑：

1. 将毫秒分解为各个时间单位（年、月、日、小时等）
2. 过滤掉所有值为0的单位
3. 将剩余单位拼接成字符串

这种过滤机制是通过内部的条件判断实现的，没有提供配置选项来修改此行为。

替代解决方案

虽然HumanizeDuration.js本身不支持配置零值显示，但可以通过组合其他工具实现类似效果。以下是基于parse-ms模块的实现方案：

function formatDurationWithZeros(ms) {
  const units = [
    { name: "小时", value: 3600000 },
    { name: "分钟", value: 60000 },
    { name: "秒", value: 1000 }
  ];
  
  let remaining = ms;
  const parts = [];
  
  units.forEach(unit => {
    const count = Math.floor(remaining / unit.value);
    remaining %= unit.value;
    parts.push(`${count} ${unit.name}`);
  });
  
  return parts.join(" ");
}

这个实现方案的特点包括：

1. 强制显示所有指定单位，无论是否为零
2. 保持与HumanizeDuration.js相似的输出格式
3. 可以灵活调整需要显示的时间单位

工程实践建议

在实际项目中处理时间格式化时，开发者应考虑：

1. 明确业务需求：是否需要精确显示所有时间单位
2. 性能考量：简单场景可以使用轻量级方案
3. 可维护性：复杂的格式化需求可能需要自定义实现

虽然HumanizeDuration.js已经进入维护模式，不再新增功能，但其设计理念和实现方式仍然值得借鉴。对于有特殊需求的场景，建议基于业务需求选择合适的技术方案，或者参考其源码实现自定义解决方案。