HumanizeDuration.js 中的单数时间单位格式化问题解析

背景介绍

HumanizeDuration.js 是一个流行的 JavaScript 库，用于将时间间隔（以毫秒为单位）转换为人类可读的字符串表示。它支持多种语言，并能将时间间隔转换为如"3分钟"、"2小时5分钟"等易读格式。

问题发现

在使用 HumanizeDuration.js 处理希伯来语时间格式化时，开发者发现了一个特殊需求：在希伯来语中，当时间单位为1时（如1天、1月），通常会省略数字"1"，直接使用时间单位名词（如"יום"表示"1天"），而不是像英语那样保留"1 day"的格式。

技术分析

HumanizeDuration.js 的当前版本在设计上存在一定局限性：

1. 语言包配置不支持针对单数情况的特殊处理
2. 输出格式相对固定，无法根据数值动态调整格式
3. 维护模式下的项目不太可能增加新功能

解决方案探索

虽然官方不建议修改核心功能，但开发者提供了几种可行的解决方案：

1. 正则表达式替换法
   通过后处理替换掉"1 "前缀：

   function transformHebrewDuration(output) {
     return output.replace(/\b1 (\p{L}+)(,|$)/gu, '$1$2');
   }
   

2. 替代库方案
   考虑使用其他类似库如 pretty-ms 或 Intl.DurationFormat

3. 项目分叉
   创建项目分支进行定制化修改

最佳实践建议

对于大多数需要类似本地化定制的开发者，推荐采用第一种正则表达式替换方案，因为它：

• 实现简单，维护成本低
• 不影响原有功能
• 可以封装为工具函数统一处理

示例完整实现：

import humanizeDuration from 'humanize-duration';

export const localizedHumanizeDuration = (ms, options) => {
  const result = humanizeDuration(ms, options);
  if (options?.language === 'he') {
    return result.replace(/\b1 (\p{L}+)(,|$)/gu, '$1$2');
  }
  return result;
};

总结思考

这个案例展示了国际化(i18n)开发中的一个常见挑战：不同语言对数字和时间表达方式的差异性处理。虽然库本身提供了基础的多语言支持，但面对特定语言的独特表达习惯时，开发者往往需要额外的处理层。

这种解决方案的思路也可以应用于其他类似场景：

• 处理不同语言中的复数形式
• 适应地区性的时间表达习惯
• 满足特定产品的文案风格要求

理解这种模式有助于开发者在面对国际化需求时，能够更灵活地设计解决方案。