JavaScript的数学计算库：decimal.js

news2024/11/27 11:44:09

An arbitrary-precision Decimal type for JavaScript.

功能

整数和浮点数
简单但功能齐全的 API
复制 JavaScript 和对象的许多方法Number.prototype Math
还处理十六进制、二进制和八进制值
比 Java 的 BigDecimal JavaScript 版本更快，更小，也许更容易使用
无依赖关系
广泛的平台兼容性：仅使用 JavaScript 1.5 （ECMAScript 3）功能
全面的文档和测试集
在引擎盖下被数学使用.js
包括一个 TypeScript 声明文件：decimal.d.ts

安装

该库是单个 JavaScript 文件 decimal.js 或 ES 模块 decimal.mjs。

浏览器：

<script src='path/to/decimal.js'></script>

<script type="module">
import Decimal from './path/to/decimal.mjs';
...
</script>

Npm：

npm install decimal.js

const Decimal = require("decimal.js");

import Decimal from "decimal.js";

import { Decimal } from "decimal.js";

使用

该库导出单个构造函数Decimal，该函数需要单个参数，即数字、字符串或十进制实例。

x = new Decimal(123.4567);
y = new Decimal("123456.7e-3");
z = new Decimal(x);
x.equals(y) && y.equals(z) && x.equals(z); // true

加减乘除

const a = new Decimal(4);
const b = new Decimal(2);
a.add(b); // 6
a.sub(b); // 2
a.mul(b); // 8
a.div(b); // 2

超过 javascript 允许的数字

如果使用超过 javascript 允许的数字的值，建议传递字符串而不是数字，以避免潜在的精度损失。

new Decimal(1.0000000000000001); // '1'
new Decimal(88259496234518.57); // '88259496234518.56'
new Decimal(99999999999999999999); // '100000000000000000000'

new Decimal(2e308); // 'Infinity'
new Decimal(1e-324); // '0'

new Decimal(0.7 + 0.1); // '0.7999999999999999'

可读性

与 JavaScript 数字一样，字符串可以包含下划线作为分隔符以提高可读性。

x = new Decimal("2_147_483_647");

其它进制的数字

如果包含适当的前缀，则也接受二进制、十六进制或八进制表示法的字符串值。

x = new Decimal("0xff.f"); // '255.9375'
y = new Decimal("0b10101100"); // '172'
z = x.plus(y); // '427.9375'

z.toBinary(); // '0b110101011.1111'
z.toBinary(13); // '0b1.101010111111p+8'

x = new Decimal(
    "0b1.1111111111111111111111111111111111111111111111111111p+1023"
);
// '1.7976931348623157081e+308'