📋 目录
一、工具类功能
把数字金额写成财务凭证上的人民币大写,例如 1234567.89 转为「壹佰贰拾叁万肆仟伍佰陆拾柒圆捌角玖分」,补零按财务口径来,支持到分、整数部分最多 16 位。
二、所需环境
JDK 17或以上
三、方法与调用示例(按需调用)
🔢 方法序号:1
🎯 方法用途:
- 把整数金额写成凭证口径的人民币大写,结尾固定补「圆整」
- 收据、发票、转账备注里只有元没有角分时用它;要精确到角分就换字符串入口
🧩 方法定义:public static String toChineseUpper(long amount)
🗣️ 入参解释:public static String toChineseUpper(long 整数金额)
📤 返回值解释:String,以「圆整」收尾的中文大写金额
💡 边界口径:
- 负数在入口就被拒,不做「负」字翻译
- long 装得下 19 位,但单位表只覆盖 16 位,超上限的整数照样在取单位之前被拦下
- 满位写法:财务口径要「壹拾」而不是「拾」,
10出「壹拾圆整」 - 内部把 long 转成字符串再走同一套规则,两个入口对同一个金额给完全相同的输出
0写作「零圆整」
🧪 方法示例:
toChineseUpper(1234567L)拿到壹佰贰拾叁万肆仟伍佰陆拾柒圆整toChineseUpper(10L)满位写「壹拾」,拿到壹拾圆整toChineseUpper(11L)拿到壹拾壹圆整toChineseUpper(110L)拿到壹佰壹拾圆整toChineseUpper(1010L)节内缺位补零,拿到壹仟零壹拾圆整toChineseUpper(0L)拿到零圆整toChineseUpper(987654321L)与字符串入口逐字比对,两个入口同值,拿到truetoChineseUpper(-1L)抛金额不能为负数,当前为-1toChineseUpper(Long.MAX_VALUE)抛IllegalArgumentException,消息是「金额整数部分最多支持 16 位,当前为 19 位: 9223372036854775807」
🔢 方法序号:2
🎯 方法用途:
- 把金额字符串写成人民币大写,小数第一位按角、第二位按分,不做四舍五入
- 报销单、合同金额要精确到分,或者拿到的是
" 000123.40 "这种带噪声的串时用
🧩 方法定义:public static String toChineseUpper(String amount)
🗣️ 入参解释:public static String toChineseUpper(金额字符串(可带两位小数))
📤 返回值解释:String,中文大写金额,角分都是 0 时以「整」收尾
💡 边界口径:
- 去掉首尾空白后必须匹配「整数部分 + 可选 1 到 2 位小数」,
.5缺整数部分、-100带负号、1,234带千分位、10.987三位小数都判非法 - 整数部分的前导零被规范化掉,
000123.40与123.40同值 - 角为 0 且有分时补一个「零」防丢位,
10.01出「壹拾圆零壹分」;角有分无时不补,10.10出「壹拾圆壹角」 - 整数部分为 0 的零钱以「零圆」起头,
0.05出「零圆零伍分」 - 跨节缺位补零,单位表有个、万、亿、万亿四节,整数部分最多 16 位
- 输出只是大写金额本身,不带币种前缀,凭证上要「人民币」三字得自己拼
🧪 方法示例:
toChineseUpper("1234567.89")拿到壹佰贰拾叁万肆仟伍佰陆拾柒圆捌角玖分toChineseUpper("10.01")角位补零,拿到壹拾圆零壹分toChineseUpper("10.10")分位是 0 就不写出来,拿到壹拾圆壹角toChineseUpper("10.11")拿到壹拾圆壹角壹分toChineseUpper("0.05")拿到零圆零伍分toChineseUpper("0.5")拿到零圆伍角toChineseUpper("0.00")拿到零圆整toChineseUpper("100000001")拿到壹亿零壹圆整toChineseUpper("100010000")拿到壹亿零壹万圆整toChineseUpper("1000000000005")拿到壹万亿零伍圆整toChineseUpper("1000000000000")拿到壹万亿圆整toChineseUpper("9999999999999999")顶到 16 位上界,拿到玖仟玖佰玖拾玖万亿玖仟玖佰玖拾玖亿玖仟玖佰玖拾玖万玖仟玖佰玖拾玖圆整toChineseUpper(" 000123.40 ")空白与前导零一起被规范化,拿到壹佰贰拾叁圆肆角toChineseUpper("2000.05")拿到贰仟圆零伍分,币种前缀不在输出里toChineseUpper("10.987")抛金额格式非法,应为非负数字且小数不超过两位,当前为: 10.987toChineseUpper(".5")抛金额格式非法,应为非负数字且小数不超过两位,当前为: .5toChineseUpper("-100")抛金额格式非法,应为非负数字且小数不超过两位,当前为: -100toChineseUpper("1,234")抛金额格式非法,应为非负数字且小数不超过两位,当前为: 1,234- 把已经转好的大写再加个「元」喂回来,同样抛
金额格式非法,应为非负数字且小数不超过两位,当前为: 零圆整元 toChineseUpper("10000000000000000")抛IllegalArgumentException,消息是「金额整数部分最多支持 16 位,当前为 17 位: 10000000000000000」toChineseUpper((String) null)抛金额字符串不能为空- 入参是一串空白时同样抛
金额字符串不能为空
四、工具类源码(可直接复制)
📦 源码文件