JS实现带小数的数字转中文金额(角分处理)

一、中文金额大写规范与角分处理核心难点

在正式编写代码前，必须明确中国人民银行《支付结算办法》关于填写票据和结算凭证的基本规定。中文大写金额不仅是阿拉伯数字的简单文字替换，更是一套具备防篡改特性的严密语法规则。

1. 核心字符映射与权值

• 大写数字：零、壹、贰、叁、肆、伍、陆、柒、捌、玖（对应阿拉伯数字 0-9）。
• 整数节内数位：拾、佰、仟（每 4 位为一组递进）。
• 进阶节权单位：元、万、亿、兆。
• 小数位单位：角（0.1）、分（0.01）。票据中最小单位为分，分以下通常做四舍五入。

2. 角分与“零”、“整”的四类核心状态

角与分在票据中的转写规则极为讲究，主要取决于角位（十分位）与分位（百分位）的具体取值：

1. 无小数或小数全为0（如 100.00）：到“元”为止，必须在“元”后追加“整”（或“正”）字，写作“壹佰元整”。
2. 角非0且分非0（如 100.25）：角和分依次转写为汉字，结尾绝对不得加“整”，写作“壹佰元贰角伍分”。
3. 角非0但分为0（如 100.20）：角位有值，分位为0。在规范中角后写“整”或不写“整”均可，但在电子凭证中追加“整”更符合防篡改惯例，写作“壹佰元贰角整”。
4. 角为0但分非0（如 100.05）：“元”与“分”之间存在空位，必须补写“零”字，写作“壹佰元零伍分”。

二、规避 JavaScript 浮点数计算精度陷阱

在 JavaScript 中实现角分转换时，很多开发者最容易犯的错误是直接使用算术乘法将小数转换为整数，例如尝试通过 Math.floor(num * 100) 提取角和分。

产生这种现象的原因是 JavaScript 遵循 IEEE 754 双精度浮点数标准，绝大多数十进制小数在二进制下是无限循环小数，进行乘除计算时会产生舍入误差。

最佳解决方案：定点化与纯字符串切分

彻底规避精度丢失的正确方式是：使用纯文本手段完成分离。

• 通过 Number(money).toFixed(2) 将数值按四舍五入规则标准化为带两位小数的字符串（如 "123.45"）。
• 通过 split('.') 沿小数点把字符串拆分为整数部分 "123" 和小数部分 "45"。
• 角字符固定为 decStr[0]，分字符固定为 decStr[1]。整个过程不涉及任何二进制乘除法，精度 100% 可靠。

三、小数角分处理的状态分支与决策设计

完成字符拆分后，小数部分由两个数字字符组成：十分位 d1（角）与百分位 d2（分）。我们需要根据其取值进入状态机。

整数部分为零时的特殊兼容

当整数部分为 0（如 0.50 或 0.05）时，财务规范有两种常见处理口径：

• 简明形式：省略“零元”，直接输出“伍角整”、“伍分”。适用于前台页面展示与发票明细。
• 严格银行凭证形式：完整保留零元，输出“零元伍角整”、“零元零伍分”。

在工程实现中，代码应当支持通过配置参数灵活切换这两种表现形式，默认采用符合人机阅读习惯的规范格式。

四、完整算法设计与生产级代码实现

下面给出一个结构严谨、支持防失真与边界防御的完整 JavaScript 实现。代码包含整数四位分节、连续多零消解、角分状态机及负数识别。

/**
 * 将带小数的数字或数字字符串转换为标准中文大写金额
 * @param {number|string} money 待转换金额
 * @param {Object} options 配置项
 * @param {boolean} options.strictZero 是否在纯小数时强制保留“零元”前缀（默认 false）
 * @returns {string} 规范的中文大写金额
 */
function digitToChinese(money, options = {}) {
  const { strictZero = false } = options;

  // 1. 基础校验与非法输入拦截
  if (money === null || money === undefined || money === '') {
    return '';
  }

  // 2. 处理负数与符号标识
  let numStr = String(money).trim();
  let prefix = '';
  if (numStr.startsWith('-')) {
    prefix = '负';
    numStr = numStr.slice(1);
  }

  const numVal = Number(numStr);
  if (isNaN(numVal)) {
    throw new TypeError('[digitToChinese] 非法金额格式，无法完成转换');
  }

  // 最大安全数保护（万亿级以上建议使用专门大数库）
  if (numVal > 99999999999999.99) {
    throw new RangeError('[digitToChinese] 金额超出支持的最大处理范围（99.99万亿）');
  }

  if (numVal === 0) {
    return '零元整';
  }

  // 3. 定点化与字符串分离，杜绝浮点失真
  const fixedStr = numVal.toFixed(2);
  const [intPart, decPart] = fixedStr.split('.');

  const CN_NUMS = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
  const CN_DIGITS = ['', '拾', '佰', '仟'];
  const CN_SECTIONS = ['', '万', '亿', '兆'];

  // 4. 整数部分四位分节转换
  let chineseInt = '';
  const intLen = intPart.length;

  if (intValIsZero(intPart)) {
    // 整数为 0
    if (strictZero) {
      chineseInt = '零元';
    }
  } else {
    let zeroFlag = false; // 记录连续零
    let sectionCount = 0;

    // 从低位向高位，每 4 位为一节处理
    for (let i = intLen; i > 0; i -= 4) {
      const start = Math.max(0, i - 4);
      const section = intPart.slice(start, i);
      let sectionStr = '';
      let sectionZero = false;

      for (let j = 0; j < section.length; j++) {
        const digit = Number(section[j]);
        const pos = section.length - j - 1;

        if (digit === 0) {
          sectionZero = true;
        } else {
          if (sectionZero) {
            sectionStr += CN_NUMS[0];
            sectionZero = false;
          }
          sectionStr += CN_NUMS[digit] + CN_DIGITS[pos];
        }
      }

      // 节不为空时追加节权单位
      if (sectionStr.length > 0) {
        chineseInt = sectionStr + CN_SECTIONS[sectionCount] + chineseInt;
      } else if (sectionCount === 2 && chineseInt.indexOf('亿') === -1) {
        // 处理整万为空但有亿级跨度的情况
        chineseInt = CN_SECTIONS[sectionCount] + chineseInt;
      }

      sectionCount++;
    }

    chineseInt += '元';
  }

  // 5. 小数角分状态判定处理
  const d1 = decPart[0]; // 角
  const d2 = decPart[1]; // 分
  let chineseDec = '';

  if (d1 === '0' && d2 === '0') {
    // 组合 1：角为0，分为0 → 结尾加“整”
    chineseDec = '整';
  } else if (d1 !== '0' && d2 === '0') {
    // 组合 2：角有值，分为0 → [角]角整
    chineseDec = CN_NUMS[Number(d1)] + '角整';
  } else if (d1 === '0' && d2 !== '0') {
    // 组合 3：角为0，分有值 → 元与分之间补“零”
    const needZero = chineseInt.length > 0 && !chineseInt.endsWith('零');
    chineseDec = (needZero ? '零' : '') + CN_NUMS[Number(d2)] + '分';
  } else {
    // 组合 4：角分均有值 → [角]角[分]分（无整）
    chineseDec = CN_NUMS[Number(d1)] + '角' + CN_NUMS[Number(d2)] + '分';
  }

  // 辅助函数：判断整数字符串是否全部为 0
  function intValIsZero(str) {
    for (let ch of str) {
      if (ch !== '0') return false;
    }
    return true;
  }

  return prefix + chineseInt + chineseDec;
}

实测执行与测试用例验证

以下是在生产场景中涵盖各种复杂边界的测试输出验证表：

五、核心规则速查与常见避坑指南

在系统对接、财务审核与发票引擎联调过程中，以下几条经验建议能够帮助开发者避开绝大多数潜在缺陷：

1. 厘位舍入规则确认

如果在计费中存在千分位（厘，如 12.346），必须提前与财务结算系统确认舍入规则：是常规的四舍五入（toFixed(2) 会将 6 进位为 5 分），还是直接截断（舍弃）。如果是银行家舍入（四舍六入五成双），需要替换 toFixed 为专门的舍入辅助函数。

2. 超过 Number.MAX_SAFE_INTEGER 的防御

JavaScript 中安全整数上限为 9,007,199,254,740,991（约 9007 万亿）。如果涉及超大数额运算（例如国家级外汇或集团资金池结算），传入 Number 会发生指数丢失。此时应重载函数，直接接收纯字符串入参，不调用 Number() 转换，直接对原始字符串进行切分。