介绍
nzh 是一个用于处理中文数字的 JavaScript 库，可以将阿拉伯数字转换成中文数字，同时支持大写、小写和金额显示格式。nzh 的核心是一个简单易用的 API，提供了丰富的参数选项和灵活的配置方式，可以轻松实现中文数字的各种转换与显示。
安装
使用 npm 安装最新版本的 nzh：
npm install nzh
或者通过 unpkg 直接引入：
<script src="https://unpkg.com/nzh"></script>
使用
转换阿拉伯数字为中文数字
nzh.cn.encodeS(1234567890) // "一十二亿三千四百五十六万七千八百九十"
nzh.cn.encodeB(1234567890) // "十二亿三千四百五十六万七千八百九十"
nzh.cn.encodeM(123456.7890) // "12万3456.789"
nzh.cn.encode(1234567890) // "一十二亿三千四百五十六万七千八百九十"
nzh.cn.encode('1234567890') // "一十二亿三千四百五十六万七千八百九十"
nzh.cn.encode(0.01) // "壹分"nzh.cn.encodeS 表示带“十”的简体中文写法，例如“一十二”。nzh.cn.encodeB 表示不带“十”的简体中文写法，例如“十二”。nzh.cn.encodeM 用于处理金额，将数字按千位分组并加上单位，例如“12万3456.789”。nzh.cn.encode 包括了以上三种写法，根据数字的大小自动选择合适的写法。nzh.cn.encode 会在开头自动去除前导零，并将小数部分处理成“角分”的形式。
转换中文数字为阿拉伯数字
nzh.cn.decodeS('一十二亿三千四百五十六万七千八百九十') // 1234567890
nzh.cn.decodeB('十二亿三千四百五十六万七千八百九十') // 1234567890
nzh.cn.decode('一十二亿三千四百五十六万七千八百九十') // 1234567890nzh.cn.decodeS 表示带“十”的简体中文写法，例如“一十二”。nzh.cn.decodeB 表示不带“十”的简体中文写法，例如“十二”。nzh.cn.decode 包括了以上两种写法，根据文字的内容自动选择合适的写法。nzh.cn.decode 会自动识别数字中的“亿”、“万”等单位，并将其转换为阿拉伯数字。
设置显示选项
-- -------------------- ---- ------- ---------------- -- -------------- ------------ ---- -- -------------- ---------- ---- -- ------------- ------- - --------- ---- -------- --- -- -- -------- -- ------- -- -- ------------- ------ ----- ------ -- ----------- ------ ----- ------ --
nzh.setOptions 可以设置 nzh 的显示选项，影响转换后的中文数字的格式和样式。可以设置的选项包括：
- moneySymbol：金额符号，默认为“￥”（人民币符号）
- moneyUnit：金额单位，默认为“元”
- format：数字格式，默认为{ thousand: ',', decimal: '.' }，表示使用逗号作为千位分隔符，使用点作为小数分隔符
- digits：保留小数位数，默认为 2
- zero：是否保留数字前导零，默认为 false
- sign：是否显示数字的正负号，默认为 false
显示示例
nzh.setOptions({ digits: 2, moneySymbol: '￥', moneyUnit: '元' })
nzh.cn.encodeM(1234567890) // "￥12,345,678.90元"
nzh.cn.encodeM(0.01) // "￥0.01元"总结
nzh 是一个十分实用的 JavaScript 库，可以快速轻松地实现中文数字的转换与显示。通过本文的介绍，你已经了解了 nzh 的基本使用方法及其各种 API，以及如何设置 nzh 的显示选项。接下来，可以尝试在自己的项目中使用 nzh，打造更优秀、更美观的中文数字显示效果。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5eedad9db5cbfe1ea0610cbf