xnumber.js

xTool.js包的子包，单独拿出来作中文文档，方便中文用户。 需要跑UT请先安装Jest: `npm i jest'

xNumber

Number relative tools of xTool

Kind: global class

• xNumber
  • new xNumber()
  • .tolerant(num) ⇒ string
  • .numberChnToBig(num) ⇒ string
  • .numberChnToSmall(num) ⇒ string
  • .numberAri2Chn(num) ⇒ string
  • .numberChn2Ari(num) ⇒ number
  • .isLegalChnNum(num) ⇒ string

new xNumber()

constructor

xNumber.tolerant(num) ⇒ string

修正中文数字常见的错误，并转小写

Kind: instance method of xNumber
Returns: string - 不校验数字拼写是否正确，只转换常错的拼写

Param	Type	Description
num	string	中文数字

xNumber.numberChnToBig(num) ⇒ string

中文数字小写转大写，“万”，“亿”是不区分大小写的

Kind: instance method of xNumber
Returns: string - 不校验数字拼写是否正确，只转换大写

Param	Type	Description
num	string	中文数字

xNumber.numberChnToSmall(num) ⇒ string

中文数字小写转大写，“万”，“亿”是不区分大小写的

Kind: instance method of xNumber
Returns: string - 不校验数字拼写是否正确，只转换大写

Param	Type	Description
num	string	中文数字

xNumber.numberAri2Chn(num) ⇒ string

阿拉伯数字转中文数字

Kind: instance method of xNumber
Returns: string - 返回中文数字

Param	Type	Description
num	number	阿拉伯数字，大于零，小于一亿亿。不要使用巨大数字，受V8引擎精度限制，10^16左右就会精度失真。Math.pow(10,16) - 1 === Math.pow(10,16) 为 true

xNumber.numberChn2Ari(num) ⇒ number

中文数字转阿拉伯数字

Kind: instance method of xNumber
Returns: number - 返回阿拉伯数字, 返回-1表示中文数字非法

Param	Type	Description
num	string	中文数字，大于零，小于一亿亿。不要使用巨大数字。接近或大于一亿亿的时候，V8引擎下的整数会出现精度问题。

xNumber.isLegalChnNum(num) ⇒ string

检查中文数字合法性，能通过基本容错也为合法

Kind: instance method of xNumber
Returns: string - true表示合法中文数字

Param	Type	Description
num	string	中文数字，大于零，小于一亿亿