一个短小精悍的四则运算 JS 工具方法库,支持浮点数精度的加减乘除计算。
提供常见的加(add
)、减(sub
)、乘(mul
)、除(div
)计算方法,可满足涉及金额、价格处理等前端数据计算的大多数应用场景。
为什么选用 asmd-calc
:
- 短小精悍。仅包含加减乘除计算,核心代码不足百行,无其他依赖,文件小巧够用
- 执行性能高。仅考虑前端可精确表达的四则运算,实现逻辑简洁,执行性能优于功能丰富复杂的开源库(详见 Benchmark 部分)
- 准确稳定。数个金融类交易系统多年开发实践经验的积累,覆盖了常见的各种计算用例误差场景
不适用的情况:
- 对于涉及超大数等
前端无法精确表示的数值处理
,建议由后端语言计算并使用字符串方式返回给前端展示。也可使用math.js
等开源库以字符串形式执行计算。 - 对于较为
复杂的数学科学计算
需求,推荐使用开源库如 math.js、decimal.js、calculatorjs、bignumber.js、big.js/等,具体可分别参见其官方文档。
# npm
npm i @lzwme/asmd-calc
# yarn
yarn add @lzwme/asmd-calc
# pnpm
pnpm add @lzwme/asmd-calc
import { add } from '@lzwme/asmd-calc';
console.log(add(0.1, 0.2, 0.3));
// => 0.6
或
import * as calc from '@lzwme/asmd-calc';
console.log(calc.add(0.1, 0.2, 0.3));
// => 0.6
const calc = require('@lzwme/asmd-calc');
console.log(calc.add(0.1, 0.2, 0.3));
// => 0.6
import { AsmdCalc } from '@lzwme/asmd-calc';
const a = new AsmdCalc(0);
console.log(+a.add(0.1).add(0.2, 0.3));
// => 0.6
const b = new AsmdCalc(0.3);
b.add(0.1, 0.2)
.add(0.1)
.sub(0.1, 0.2)
.sub(0.1)
.div(0.3)
.mul(0.3);
console.log(+b);
// => 0.3
console.log(b.value);
// => 0.3
const AsmdCalc = require('@lzwme/asmd-calc').AsmdCalc;
const calc = new AsmdCalc(0);
console.log(calc.add(0.1).add(0.2, 0.3));
// => 0.6
add(...args)
加法运算sub(...args)
减法运算mul(...args)
乘法运算div(...args)
除法运算keepDotLength(value, len, isRounding = false)
保留 N 位小数(支持四舍五入或截断)toFixed(value, len)
保留 N 位小数(四舍五入,返回字符串)getDecimalLen(num)
获取指定数值的小数位长度toNonExponential(num)
将指定的浮点数转换为非科学计数法的字符串格式
- 开发
pnpm install
pnpm start
- 测试
# 单元测试
npm test
# 基准测试
npm run benchmark
- 构建
npm run build
npm run benchmark
基准测试代码参见:Benchmark
以下结果为在同一机器上分别执行 10000*N
次的耗时对比:
type/times | jsRaw | asmd-calc | mathjs |
---|---|---|---|
add-10000 | 19.225ms | 169.535ms | 415.145ms |
sub-10000 | 16.269ms | 34.827ms | 171.263ms |
mul-10000 | 18.518ms | 51.625ms | 235.868ms |
div-10000 | 27.025ms | 79.504ms | 300.706ms |
预执行 100_000
次后再执行 10000*N
次的耗时对比:
type/times | jsRaw | asmd-calc | mathjs |
---|---|---|---|
add-10000 | 7.768ms | 155.836ms | 362.819ms |
sub-10000 | 8.339ms | 25.147ms | 155.611ms |
mul-10000 | 9.995ms | 35.685ms | 224.357ms |
div-10000 | 15.666ms | 77.407ms | 280.322ms |
@lzwme/asmd-calc
is released under the MIT license.
该插件由志文工作室开发和维护。