中文金额数字转阿拉伯数字
- 🏦 规范:符合中国人民银行规定的书写标准。
- 📦 零依赖:无需依赖其他库或框架。
- ⚙️ 支持 ESM、CJS 和 IIFE 引入:可根据项目需求选择合适的引入方式。
- 📝 支持简体中文和繁体中文的大小写数字:满足不同语境下的需求。
- 🔢 大数支持:显示大数无精度问题,保持精确性。
- 🔧 可自定义配置:根据个人需求调整库的行为和设置。
npm install zh-currency-to-number
import { zhCurrencyToNumber } from "zh-currency-to-number";
zhCurrencyToNumber("人民币零圆整"); // "¥0"
zhCurrencyToNumber("人民币壹角贰分"); // "¥0.12"
zhCurrencyToNumber("人民币壹万陆仟肆佰零玖圆零贰分"); // "¥16409.02"
zhCurrencyToNumber("人民币壹万陆仟肆佰零玖圆零贰分", { thousandsSeparator: true }); // "¥16,409.02"
zhCurrencyToNumber("人民币负叁圆贰角整"); // "¥-3.2"
中文大写数字金额规范参见中国人民银行发布的 支付结算办法 附一 正确填写票据和结算凭证的基本规定。
你可以借助 script 标签直接通过 CDN 来使用:
<script src="https://unpkg.com/zh-currency-to-number/dist/zh-currency-to-number.global.js"></script>
<script>console.log(__ZH_CURRENCY_TO_NUMBER__.zhCurrencyToNumber(11));</script>
这里我们使用了 unpkg,但你也可以使用任何提供 npm 包服务的 CDN,例如 jsdelivr 或 cdnjs。当然,你也可以下载此文件并自行提供服务。
Type: number | string
需要转换的中文数字金额,即使是超大数字也无精度丢失问题。
Type: "zh-CN-lowercase" | "zh-CN-uppercase" | "zh-TW-lowercase" | "zh-TW-uppercase" | "zh-HK-lowercase" | "zh-HK-uppercase"
Default: "zh-CN-uppercase"
指定输入的中文数字,HK 和 TW 没有区别都表示繁体中文。
Type: string[]
Default: ["角", "分"]
人民币辅币单位。
Type: string
Default: ¥
阿拉伯数字前面的人民币符号。
Type: string
Default: 人民币
中国人民银行规定,中文大写金额数字要紧跟在「人民币」三个字后面。
Type: string
Default: 圆
中国人民银行规定,人民币单位是圆活着元,两个都是有效的。
Type: string
Default: 整
中国人民银行规定,中文大写金额数字到「元」为止的,在元之后,应写「整」(或「正」)字,在「角」之后可以不写「整」(或「正」)字。大写金额数字有「分」的,「分」后面不写「整」(或「正」)字。
参见 zhToNumber 函数的 options。
MIT License © 2023-Present Condor Hero