zh-to-number

v0.0.1

Published

9 months ago

中文数字转阿拉伯数字

Downloads

0High
0Medium
0Low

condorhero

number-to-zh zh-to-number number-to-zh-currency money-to-number 中文数字转阿拉伯数字阿拉伯数字转中文数字

Zh-to-number

Downloads

中文数字转阿拉伯数字

Highlights

📦 零依赖：无需依赖其他库或框架。
⚙️ 支持 ESM、CJS 和 IIFE 引入：可根据项目需求选择合适的引入方式。
📝 支持简体中文和繁体中文的大小写数字：满足不同语境下的需求。
🔢 大数支持：显示大数无精度问题，保持精确性。
🔧 可自定义配置：根据个人需求调整库的行为和设置。

Install

npm install zh-to-number

Usage

为了避免大数精度丢失问题，阿拉伯数字作为字符串返回

import { zhToNumber } from "zh-to-number";

zhToNumber("你好");                                         // NaN
zhToNumber("零");                                           // "0"
zhToNumber("零点一");                                       // "0.1"
zhToNumber("一千万零一");                                   // "10000001"
zhToNumber("一千二百三十四万五千六百七十八");                   // "12345678"
zhToNumber("一十");                                        // "10"
zhToNumber("十");                                         // "10"
zhToNumber("壹仟万零壹", { language: "zh-CN-uppercase" }); // "10000001"

CDN

你可以借助 script 标签直接通过 CDN 来使用：

<script src="https://unpkg.com/zh-to-number/dist/zh-to-number.global.js"></script>
<script>console.log(__ZH_TO_NUMBER__.zhToNumber("一十"));</script>

这里我们使用了 unpkg，但你也可以使用任何提供 npm 包服务的 CDN，例如 jsdelivr 或 cdnjs。当然，你也可以下载此文件并自行提供服务。

自定义数级

默认最大支持到 10^16，即千万亿，最小支持到 10^-16，如果使用万万和亿亿则没有限制。如果超出数级则会返回 NaN，不过可以自定义数级。

import { zhToNumber, RESOURCES } from "zh-to-number";

const options = {
	language: "zh-CN-lowercase" as const,
	magnitudeList: [...RESOURCES["zh-CN-lowercase"].magnitudeList, "京"],
};
zhToNumber("一京", options) // "10000000000000000"

API

zhToNumber(inputNumberString, options?)

inputNumberString

Type: string

需要转换的中文数字，即使是超大数字也无精度丢失问题。

options

language

不同的中文数字转为阿拉伯数字，HK 和 TW 没有区别都表示繁体中文。

thousandsSeparator

Type: boolean
Default: false

添加千分分隔符。

digitsList

Type: string[]
Default: ["", "十", "百", "千"]

对应语言的数位列表。

magnitudeList

Type: string[]
Default: ["", "万", "亿", "兆"]

对应语言的数级列表。

baseNumerals

Type: string[]
Default: ["零", "一", "二", "三", "四", "五", "六", "七", "八", "九"]

对应语言从零到九的中文数字列表。

minusSign

Type: string
Default: 负

对应语言「负」的写法。

positive

Type: string
Default: 正

对应语言「正」的写法。

decimalPoint

Type: string
Default: 点

对应语言「点」的写法。