引入

import {
  NUMBER_CHI_MAP,
  getUnitPreviousRatio,
  getPartRatio,
  getThousandSeparator,
  getThousandSeparator2,
  random,
  padZero,
  addNumber,
  range
} from 't-comm';

// 不支持 tree-shaking 的项目
import {
  NUMBER_CHI_MAP,
  getUnitPreviousRatio,
  getPartRatio,
  getThousandSeparator,
  getThousandSeparator2,
  random,
  padZero,
  addNumber,
  range
} from 't-comm/lib/number/index';

// 只支持 ESM 的项目
import {
  NUMBER_CHI_MAP,
  getUnitPreviousRatio,
  getPartRatio,
  getThousandSeparator,
  getThousandSeparator2,
  random,
  padZero,
  addNumber,
  range
} from 't-comm/es/number/index';

NUMBER_CHI_MAP

描述：

阿拉伯数字和中文数字映射表，0 - 32

参数：

示例

console.log(NUMBER_CHI_MAP[1]);
// '一'

console.log(NUMBER_CHI_MAP[2]);
// '二'

getUnitPreviousRatio(value, preValue)

描述：

获取相对于过去数据的比例

参数：

参数名	类型	描述
value	number	当前数据
preValue	number	之前数据

返回: string

比例

示例

getUnitPreviousRatio(1, 0)
// +999+%

getPartRatio(summary, part)

描述：

获取占比

参数：

参数名	类型	描述
summary	number	总数据
part	number	部分数据

返回: number

比例

示例

getRatio(0, 1)
// 0

getRatio(1, 0)
// 0

getRatio(1, 1)
// 100

getRatio(1, .5)
// 50

getThousandSeparator(value)

描述：

获取千分位分隔符

参数：

参数名	类型	描述
value	string | number	输入数字

返回: string

处理后的数字

示例

getThousandSeparator('123123123')

// => 123,123,123

getThousandSeparator('12312312')

// => 12,312,312

getThousandSeparator2(value)

描述：

获取千分位分隔符，处理数字之间有空格的情况

参数：

参数名	类型	描述
value	string | number	输入数字

返回: string

处理后的数字

示例

getThousandSeparator2('12345678 123456789')

// => 12,345,678 123,456,789

random(min, max)

描述：

在区间内获取随机整数

参数：

参数名	类型	描述
min	number	最小值
max	number	最大值

返回:

随机数

示例

random(0, 19) // 1

padZero(num, [targetLength])

描述：

数字左侧加 0，直到满足长度要求

参数：

参数名	类型	默认值	描述
num	string | number		当前数字
[targetLength]	number	2	目标长度

返回: string

新的字符串

示例

padZero(1, 3); // 001

addNumber(num1, num2)

描述：

add num and avoid float number

参数：

参数名	类型	描述
num1	number	第1个数字
num2	number	第2个数字

返回: number

结果

示例

addNumber(0.1, 0.2); // 0.3

range(num, min, max)

描述：

根据边界值修正数字

参数：

参数名	类型	描述
num	number	待处理的数字
min	number	边界最小值
max	number	边界最大值

返回: number

处理结果

示例

range(12, 1, 2); // 2