【工具类】数字转中文大写金额（附完整踩坑之路）

前言

项目中有需求是将用户订单生成pdf合同的，然后就涉及到了合同金额需要大写金额的问题。
本想着这种转换的工具类一搜一大把，就直接从网上copy了一个下来，使用过程中发现网上的大部分转换类都是有问题的。。。
由于我们生成pdf合同是走线上盖章生效的，因为这个大写金额的问题导致了一部分用户合同金额对不上的问题。
一起严重的生产事故由此诞生了。。。。。。

防坑指南

1. 首先大部分的工具类在转换整数或小数为 .00 时，最终的中文金额不带 ”整“
2. 其次在转换 0.12 这种元为0 但是有角分的情况时，最终的中文金额却变成了 ”元壹角两分“
3. 再其次转换 1097500 时 结果是否为”壹佰零玖万柒仟伍佰元整“ ，有的转换之后输出了 ”壹佰玖万柒仟伍佰元整“，没有零

附上没问题的工具类

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class MoneyUtil {
    private static final Pattern AMOUNT_PATTERN = Pattern.compile("^(0|[1-9]\\d{0,11})\\.(\\d\\d)$");
    private static final char[] RMB_NUMS = "零壹贰叁肆伍陆柒捌玖".toCharArray();
    private static final String[] UNITS = {"元", "角", "分", "整"};
    private static final String[] U1 = {"", "拾", "佰", "仟"};
    private static final String[] U2 = {"", "万", "亿"};

    /**
     * 将金额（整数部分等于或少于12位，小数部分2位）转换为中文大写形式.
     * @param amount 金额数字
     * @return 中文大写
     */
    public static String toChinese(String amount) throws IllegalArgumentException {
        // 去掉分隔符
        amount = amount.replace(",", "");

        //转为统一格式
        amount = moneyFormat(amount);

        // 验证金额正确性
        if (amount.equals("0.00")) {
            throw new IllegalArgumentException("金额不能为零.");
        }
        Matcher matcher = AMOUNT_PATTERN.matcher(amount);
        if (!matcher.find()) {
            throw new IllegalArgumentException("输入金额有误.");
        }

        String integer = matcher.group(1);  // 整数部分
        String fraction = matcher.group(2); // 小数部分

        String result = "";
        if (!integer.equals("0")) {
            result += integer2rmb(integer) + UNITS[0]; // 整数部分
        }

        if (fraction.equals("00")) {
            result += UNITS[3]; // 添加[整]
        } else if (fraction.startsWith("0") && integer.equals("0")) {
            result += fraction2rmb(fraction).substring(1); // 去掉分前面的[零]
        } else {
            result += fraction2rmb(fraction); // 小数部分
        }

        return result;
    }

    // 将金额小数部分转换为中文大写
    private static String fraction2rmb(String fraction) {
        char jiao = fraction.charAt(0); // 角
        char fen = fraction.charAt(1);  // 分
        return (RMB_NUMS[jiao - '0'] + (jiao > '0' ? UNITS[1] : ""))
                + (fen > '0' ? RMB_NUMS[fen - '0'] + UNITS[2] : "");
    }

    // 将金额整数部分转换为中文大写
    private static String integer2rmb(String integer) {
        StringBuilder buffer = new StringBuilder();
        // 从个位数开始转换
        int i, j;
        for (i = integer.length() - 1, j = 0; i >= 0; i--, j++) {
            char n = integer.charAt(i);
            if (n == '0') {
                // 当n是0且n的右边一位不是0时，插入[零]
                if (i < integer.length() - 1 && integer.charAt(i + 1) != '0') {
                    buffer.append(RMB_NUMS[0]);
                }
                // 插入[万]或者[亿]
                if (j % 4 == 0) {
                    if (i > 0 && integer.charAt(i - 1) != '0'
                            || i > 1 && integer.charAt(i - 2) != '0'
                            || i > 2 && integer.charAt(i - 3) != '0') {
                        buffer.append(U2[j / 4]);
                    }
                }
            } else {
                if (j % 4 == 0) {
                    buffer.append(U2[j / 4]);     // 插入[万]或者[亿]
                }
                buffer.append(U1[j % 4]);         // 插入[拾]、[佰]或[仟]
                buffer.append(RMB_NUMS[n - '0']); // 插入数字
            }
        }
        return buffer.reverse().toString();
    }

    /**
     * 对金额的格式调整到分
     *
     * @param money xx
     * @return xx.00
     */
    public static String moneyFormat(String money) {
        StringBuffer sb = new StringBuffer();
        if (money == null) {
            return "0.00";
        }
        int index = money.indexOf(".");
        if (index == -1) {
            return money + ".00";
        } else {
            String s0 = money.substring(0, index);//整数部分
            String s1 = money.substring(index + 1);//小数部分
            if (s1.length() == 1) {//小数点后一位
                s1 = s1 + "0";
            } else if (s1.length() > 2) {//如果超过3位小数，截取2位就可以了
                s1 = s1.substring(0, 2);
            }
            sb.append(s0);
            sb.append(".");
            sb.append(s1);
        }
        return sb.toString();
    }


    public static void main(String[] args) throws Exception {
        System.out.println("123456789.23 转换--->" + toChinese("123456789.23"));
        System.out.println("40.00 转换--->" + toChinese("40.00"));
        System.out.println("4001.01 转换--->" + toChinese("4001.01"));
        System.out.println("40001.01 转换--->" + toChinese("40001.01"));
        System.out.println("304001.30 转换--->" + toChinese("304001.30"));
        System.out.println("10000000.00 转换--->" + toChinese("10000000.00"));
        //第一坑 整数时 输出时末尾是否带整
        System.out.println("10000000 转换--->" + toChinese("10000000"));
        //第二坑 0.12 输出是否为壹角二分
        System.out.println("0.12 转换--->" + toChinese("0.12"));
        //第三坑 1097500 输出是否为 壹佰零玖万柒仟伍佰元整
        System.out.println("1097500 转换--->" + toChinese("1097500"));
    }
}

工具类参考链接：java实现数字金额转换成汉字大写金额