Math

// 从 4.12.0 版本开始，规范了有效数值。（注意：4.12.3 对有效数值重新定义）
// 有效数值即能通过 Number(value) 转为数字，且不能为 NaN 。

// 以下为有效数值：
// 1. 数字: 1, -1, 1e-2, 1.312, 0.1, Infinity
// 2. 字符串: '1', '10e2', '-1', '0.1', '', ' ', '  15', ' 15   '
// 3. 其他类型: null, new Date(), [], new Array(), true, false,...

// 以下为无效数值：
// 1. 字符串: '1a', '-12a', '10.2.2', '10e2.1'
// 2. 其他类型: undefined, [], {}, Symbol(), function(){}, ()=>{}

// 计算说明：
// 四则运算的第二个参数都是有默认值（乘数和除数默认1，加数和减数默认0）
plus(); // NaN  0个参数时，被加数转换为 Number(undefined) NaN ，NaN+0 = NaN 。其他计算方法如果没有参数一样返回 NaN 。
plus(0.1); // 0.1  第二个参数，加数默认为 0
plus(undefined, 0.1); // NaN  第一个参数被加数转换为 Number(undefined) NaN ，NaN+0 = NaN 。其他计算方法如果第一个参数为无效数值一样返回 NaN 。
plus(true, null); // 1  Number(true) 转换为 1 ， Number(null) 转换为 0 ， 1+0=1

// 2. 参数中包含无效数值，返回NaN
plus('0.1', ' a'); // NaN
plus(true, {}); // NaN
plus(true, 0.1, Symbol()); // NaN

// 注意：
// 如果第二个及后面的参数如果值为 undefined 取默认值，即乘除数取 1 ，加减法取 0 。
plus(0.1, undefined); // 0.1
plus(0.1, undefined, 0.2, undefined); // 0.3  后面的 undefined 取默认值 0
times(0.1, undefined, 0.2, undefined); // 0.02  后面的 undefined 取默认值 1

Methods

(static) divide(…nums) → {number}

Description:

• 精确除法，支持多个数相除，除数默认为 1 。

Source:

• divide.js, line 23

Since:

• 3.1.0

Example

divide(1.21); // 1.21 除数默认为 1 ，即 1.21/1 = 1.21
divide(1.21, 1.1); // 1.1
divide(1000, 10, 10); // 10
divide(1000, 10, 10, 10); // 1

divide(); // NaN  如果没有传入参数，被除数默认为 undefined 。 Number(undefined) 转换为 NaN ，NaN/1 = NaN
divide(null); // 0  Number(null) 转换为 0 ， 0/1 = 0
divide('1.5 ', 0.5); // 3  Number('1.5 ') 转换为 1.5 ，1.5/0.5 = 3

Parameters:

Returns:

Type

number

(static) gcd(…nums) → {number}

Description:

• 最大公约数，使用辗转相除法。

  遵循以下约定：

  1. 如果参数中包含无效数值，返回 NaN 。
  2. 如果全部参数都为 0 ，返回 0 。
  3. 如果参数包含 0 ，仅计算非零的数。
  4. 如果参数为负数，将转为绝对值的正数。
  5. 如果参数包含小数点，将转为四舍五入的整数。

Source:

• gcd.js, line 28

Since:

• 4.20.0

See:

• 最大公约数

Example

gcd(8, 14); // 2
gcd(57, 48); // 3
gcd(140, 21, 42); // 7
gcd('foo', 'bar'); // NaN
gcd(0, 10); // 10
gcd(2.3, 3.8, 8, -10); // 2

Parameters:

Returns:

Type

number

(static) lcm(…nums) → {number}

Description:

• 最小公倍数。

  遵循以下约定：

  1. 如果参数中包含无效数值，返回 NaN 。
  2. 如果只有一个参数，另一个参数默认为 1 。
  3. 如果全部参数都为 0 ，返回 NaN 。因为作为除数的最大公约数为 0 ，结果为 NaN 。
  4. 如果全部参数都为 Infinity ，返回 NaN 。因为除数和被除数都是 Infinity ，结果为 NaN 。
  5. 如果参数包含 0 ，返回 0 。
  6. 如果参数为负数，将转为绝对值的正数。
  7. 如果参数包含小数点，将转为四舍五入的整数。

Source:

• lcm.js, line 33

Since:

• 4.20.0

See:

• 最小公倍数

Example

lcm(3, 4); // 12
lcm(8, 4); // 8
lcm(2, 4, 8); // 32
lcm('foo', 'bar'); // NaN
lcm(0, 10); // 0
lcm(2.3, 3.8, 8, -10); // 320

Parameters:

Returns:

Type

number

(static) minus(…nums) → {number}

Description:

• 精确减法，支持多个数相减，减数默认为 0 。

Source:

• minus.js, line 19

Since:

• 3.1.0

Example

minus(1); // 1
minus(1, 0.9); // 0.1
minus(1, 0.9, 0.02); // 0.08
minus(1, 0.9, 0.02, 0.08); // 0

Parameters:

Returns:

Type

number

(static) plus(…nums) → {number}

Description:

• 精确加法，支持多个数相加，加数默认为 0 。

Source:

• plus.js, line 19

Since:

• 3.1.0

Example

plus(0.1); // 0.1
plus(0.1, 0.2); // 0.3
plus(0.1, 0.2, 0.3); // 0.6
plus(0.1, 0.2, 0.3, 0.4); // 1

Parameters:

Returns:

Type

number

(static) round(num, precisionopt) → {number}

Description:

• 四舍五入，支持设置精度

Source:

• round.js, line 17

Since:

• 3.1.0

Example

round(4.006); // 4
round(4.006, 2); // 4.01
round(4060, -2); // 4100

Parameters:

Returns:

Type

number

(static) times(…nums) → {number}

Description:

• 精确乘法，支持多个数相乘，乘数默认为 1 。

Source:

• times.js, line 18

Since:

• 3.1.0

Example

times(3); // 3
times(3, 0.6); // 1.8
times(3, 0.6, 2); // 3.6
times(3, 0.6, 2, 10); // 36

Parameters:

Returns:

Type

number