@lzwme/asmd-calc v1.0.4

@lzwme/asmd-calc

一个短小精悍的四则运算 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
pnpm add @lzwme/asmd-calc
# pnpm
pnpm add @lzwme/asmd-calc

用法 (USEAGE)

1. 使用简单的工具方法计算示例

es module

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

commonjs

const calc = require('@lzwme/asmd-calc');

console.log(calc.add(0.1, 0.2, 0.3));
// => 0.6

2. 使用链式操作类计算示例

es module

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

commonjs

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

API

• add(...args) 加法运算
• sub(...args) 减法运算
• mul(...args) 乘法运算
• div(...args) 除法运算
• keepDotLength(value: number | string, precision: number, type: 'ceil' | 'round' | 'fround' | 'floor' | boolean = 'floor'): number | null 保留 N 位小数，返回数值
• toFixed(value: number | string, precision: number, type: 'ceil' | 'round' | 'fround' | 'floor' | boolean = 'floor'): number | null 保留 N 位小数(默认四舍五入floor，返回字符串)
• getDecimalLen(num) 获取指定数值的小数位长度
• toNonExponential(num) 将指定的浮点数转换为非科学计数法的字符串格式

开发与测试

• 开发

pnpm install
pnpm start

• 测试

# 单元测试
npm test

# 基准测试
npm run benchmark

• 构建

npm run build

Benchmark

npm run benchmark

基准测试代码参见：Benchmark

以下结果为在同一机器上分别执行 10000*N 次的耗时对比：

预执行 100_000 次后再执行 10000*N 次的耗时对比：

Benchmark Details

随机数据集（测试用例）:

纯小数数据集:

纯整数数据集:

相关参考

• 确保前端 JavaScript 浮点数精度的四则运算方法

License

@lzwme/asmd-calc is released under the MIT license.

该插件由志文工作室开发和维护。