Units-conversion NPM

units-conversion

快捷帮忙开发替换单位的库，包含时间，内存大小，数值

安装

npm install units-conversion

引入

// ConverTim - 转换时间
// ConverMemory - 转换内存大小
// ConverValue - 转换数值
// UnitConversionFactory - 自定义
import {
  ConverTim,
  ConverMemory,
  ConverValue,
  UnitConversionFactory,
} from "units-conversion";

使用

1、转换值

转换值不带单位时，默认最小转换

ConverTime.converValue("1000"); // {result: { text: '1', unit: 's', value: '1s' }}
ConverTime.converValue("1000s"); // { result: { text: '17', unit: 'min', value: '17min' }}

2、保留小数

toFixed

默认保留 0 位小数

// 默认不保留小数
ConverTime.converValue("1000"); // { result: { text: '17', unit: 'min', value: '17min' }}

// 保留2位小数
ConverTime.converValue("1000s", { toFixed: 2 }); // {result: { text: '16.67', unit: 'min', value: '16.67min' }}

3、末尾 0 抛弃

abandonZero

默认抛弃末尾没有意义的 0, 通常和 toFixed 连用

// 保留末尾的0
ConverTime.converValue("1000", { toFixed: 2, abandonZero: false }); // {result: { text: '1.00', unit: 's', value: '1.00s' }}

4、单位转换

unitType

默认不开启单位转换（使用内置默认配置中的 key 字段名）

ConverTime.converValue("1000", { toFixed: 2, abandonZero: false }); // {result: { text: '1.00', unit: 's', value: '1.00s' }}

ConverTime.converValue("1000", {
  toFixed: 2,
  abandonZero: false,
  unitType: "zh",
}); // {result: { text: '1.00', unit: '秒', value: '1.00秒' }}

函数说明

行数名称	函数作用	说明
ConverTime	时间转换	converValue--待转化值，小转大, 可带单位; formateConfig
ConverMemory	内存转换	converValue--待转化值，小转大, 可带单位; formateConfig
ConverValue	内存转换	converValue--待转化值，小转大, 可带单位; formateConfig

formateConfig 配置说明

配置	类型	说明	可选值	进度
formateConfig.converTo	string	转化到哪一个单位		待完成
formateConfig.unitType	string \| undefined	使用什么单位	undefined\|'zh'	完成
formateConfig.valueType	string \| undefined	数值转中文，默认不转	undefined\|'zh'	完成
formateConfig.toFixed	number \|undefined	保留几位小数，默认 0	undefined\|number	完成
formateConfig.abandonZero	boolean \| undefined	是否抛弃小数点和后面的 0, 通常和 toFixed 连用	undefined\|true\|false	完成

内置转换单位枚举

y （年）
m（月）
w（周）
d（天）
h（小时）
min（分钟）
s（秒）
ms（毫秒）

千亿
百亿
十亿
亿
千万
百万
十万
万
千
百
十
一

UnitConversionFactory 自定义转换类使用说明

import { UnitConversionFactory } from "units-conversion";

let myConver = new UnitConversionFactory([
  { unit: "千亿", zh: "仟", scale: 10 },
  { unit: "百亿", zh: "佰", scale: 10 },
  { unit: "十亿", zh: "拾", scale: 10 },
  { unit: "亿", zh: "亿", scale: 10 },
  { unit: "千万", zh: "仟", scale: 10 },
  { unit: "百万", zh: "佰", scale: 10 },
  { unit: "十万", zh: "拾", scale: 10 },
  { unit: "万", zh: "万", scale: 10 },
  { unit: "千", zh: "仟", scale: 10 },
  { unit: "百", zh: "佰", scale: 10 },
  { unit: "十", zh: "拾", scale: 10 },
  { unit: "", zh: "", scale: 1 },
]);

myConver.converValue("1001百"); // {result: '1十万01百'}
myConver.converValue("1001百", {
  valueType: "zh",
}); // {result: '壹十万零壹百}