JS取整方法大全：Math.floor、ceil、round与trunc的区别

ECMAScript 数值处理技术指南

一、四大核心取整方法的核心定义与朝向

对浮点数进行取整是前端与 Node.js 开发中的高频操作。很多初学者容易将它们简单理解为“四舍五入”或“抹去小数”，但在实际项目中，一旦输入数据出现负数或临界小数（如分页计算、金额结算、物理模拟或图表坐标计算），错误的方法选型就会引发隐蔽的数据漂移。

理解这四个方法的最佳途径是建立统一的“数轴朝向模型”。在数轴上，左侧是负无穷大（-∞），右侧是正无穷大（+∞），中间是零点（0）：

• Math.floor(x)（向下取整）：返回小于或等于指定数值的最大整数。它的移动方向永远朝向数轴左侧（-∞）。
• Math.ceil(x)（向上取整）：返回大于或等于指定数值的最小整数。它的移动方向永远朝向数轴右侧（+∞）。
• Math.trunc(x)（截断取整）：直接剥除小数点及其后面的所有小数位，只保留整数部分。它的移动方向永远朝向数轴中间的零点（0）。该方法在 ES6 (ECMAScript 2015) 中标准化。
• Math.round(x)（四舍五入）：返回与指定数值最接近的整数。当小数部分恰好为 0.5 时，规范定义其向数轴正无穷（+∞）方向靠拢。

二、正负数运行表现与底层机制对比

为了清晰展现各方法在正负数区间的具体差异，我们输入同一组对称测试数据：正数 +3.7、+3.5、+3.2 以及负数 -3.2、-3.5、-3.7。

输入数值 (x)	Math.floor(x)	Math.ceil(x)	Math.trunc(x)	Math.round(x)	计算规律与特征说明
+3.7	3	4	3	4	正数小数大于0.5：floor与trunc一致，ceil与round一致
+3.5	3	4	3	4	正数临界半数：round向上舍入到4
+3.2	3	4	3	3	正数小数小于0.5：floor、trunc与round一致均为3
-3.2	-4	-3	-3	-3	负数小数小于0.5：floor下沉到-4，trunc直接抹除小数得-3
-3.5	-4	-3	-3	-3	负数临界半数：round(-3.5)结果为-3，而非-4
-3.7	-4	-3	-3	-4	负数小数大于0.5：floor与round均为-4，trunc抹除得-3

核心差异深度剖析

从表格中可以提炼出三个极易引发缺陷的核心认知：

1. Math.floor 与 Math.trunc 在负数时的分歧：
   很多开发者习惯用 Math.floor 来“去除小数位”。对正数 3.7，Math.floor(3.7) 确实输出 3，与 Math.trunc(3.7) 相同。但在负数时，Math.floor(-3.7) 会继续向数轴负方向滑动得到 -4；而 Math.trunc(-3.7) 才是真正字面意义上的“抹去小数点”，输出 -3。
2. Math.round 的负半数机制规范：
   在 ECMAScript 规范定义中，Math.round(x) 等价于 Math.floor(x + 0.5)（除部分特殊符号零边界外）。当代入 -3.5 时：

   Math.floor(-3.5 + 0.5) = Math.floor(-3.0) = -3;

   因此，Math.round(-1.5) 的结果是 -1，Math.round(-3.5) 的结果是 -3。它并没有像数学日常教学中的“绝对值四舍五入”那样远离原点变成 -4。
3. Math.ceil 遇到负数时的行为：
   Math.ceil(-3.2) 结果是 -3。因为 -3 比 -3.2 大，向正无穷方向前进时，遇到的第一个整数就是 -3。

三、业务常见场景与方法选型推导

在实际编码中，选错取整方法通常不会导致程序直接抛出异常，而是会表现为“偶尔少一页”、“倒计时多跳一秒”或“财务对账出现一分钱差额”。根据业务目标的数学本质进行推导，是确保代码健壮的关键。

场景 1：分页总页数计算（必须使用 Math.ceil）

在列表展示、表格分页时，总条数除以每页容量往往带有余数。无论余数多么微小（例如 101 条数据，每页 10 条，商为 10.1），都必须再开辟一页来容纳多出的数据。此时向上取整是唯一正确的解法。

// 分页计算标准范式
function getTotalPages(totalCount, pageSize) {
    if (pageSize <= 0) throw new Error("pageSize 必须大于 0");
    return Math.ceil(totalCount / pageSize);
}

// 测试验证
console.log(getTotalPages(101, 10)); // 输出: 11
console.log(getTotalPages(100, 10)); // 输出: 10

场景 2：时间倒计时换算（使用 Math.floor 或 Math.trunc）

当把剩余毫秒数换算为秒、分钟或小时时，未达到完整单位的部分不应被提前计入。例如剩余 59.8 秒，在界面上应当展示为 59 秒而不是 60 秒。由于时间跨度始终大于等于 0，此时 Math.floor 和 Math.trunc 效果完全等价。

// 毫秒格式化为 mm:ss 范式
function formatCountdown(remainMs) {
    const totalSeconds = Math.floor(remainMs / 1000);
    const minutes = Math.floor(totalSeconds / 60);
    const seconds = totalSeconds % 60;
    return `${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;
}

console.log(formatCountdown(65900)); // 输出: "01:05" (剩余65.9秒，不进位为01:06)

场景 3：区间随机整数生成（依赖 Math.floor）

使用 Math.random() 生成 [min, max] 闭区间的整数时，由于 Math.random() 的取值范围是 [0, 1)（包含 0 但严格小于 1），如果使用 Math.round 会导致区间两端的概率减半；而如果使用 Math.floor，每个整数所分配到的区间长度恰好均匀为 1。

// 生成 [min, max] 的等概率随机整数
function getRandomInt(min, max) {
    const lower = Math.ceil(min);
    const upper = Math.floor(max);
    // 区间包含两端，乘以差值加 1 后用 floor 取整
    return Math.floor(Math.random() * (upper - lower + 1)) + lower;
}

四、位运算取整与 parseInt 的对比与安全边界

在很多开源库或老旧代码中，经常能看到形如 x | 0、~~x、x >> 0 甚至 parseInt(x, 10) 的取整写法。了解它们的底层限制能够避免线上灾难。

1. 位运算符取整（按位或、双按位非、右移）

在 JavaScript 中，任何位运算都会先把操作数转换为 32 位有符号整数（ToInt32），运算完成后再转回 64 位浮点数格式。因此，num | 0 和 ~~num 的效果在数值上等价于 Math.trunc()（都是直接截断小数向零靠近），但在数值安全范围上存在严格天花板：

• 有效整数范围：[-2147483648, 2147483647]（即 $-2^{31}$ 到 $2^{31}-1$）。
• 溢出隐患：当数值超过 21.47 亿（例如时间戳、高位雪花 ID、大额资金流水）时，位运算会导致高位符号溢出甚至反转为负数：

  const timestamp = 1730000000000; // 毫秒时间戳
  console.log(Math.trunc(timestamp)); // 输出: 1730000000000 (安全)
  console.log(timestamp | 0);          // 输出: -1071275008 (严重错误！符号反转)

2. parseInt(string, radix) 的字符化陷阱

parseInt 的核心使命是解析字符串为整数，绝非数值取整函数。当向其传入数值时，JavaScript 引擎会先执行 toString() 操作：

• 对于非常小或非常大的浮点数，toString() 会使用科学计数法：

  // 极小浮点数陷阱
  const num = 0.0000005;
  console.log(String(num));        // 输出: "5e-7"
  console.log(parseInt(num, 10));  // 输出: 5 (本应为 0！)
  console.log(Math.trunc(num));    // 输出: 0 (正确)

• 解析过程存在字符串转换开销，在循环或高频调用中性能远低于 Math 原生方法。

五、总结与编码建议

归纳 JavaScript 取整方法的差异与选型，可以提炼为以下三条直观准则：

• 需要完全容纳剩余量：毫不犹豫选用 Math.ceil（如总页数、最少容器批次）。
• 需要纯粹抹除小数部分：首选 Math.trunc。它在 ES6 中标准化，无论正负数均对称向原点截断，比 Math.floor 更符合“抹零”语义，且完全避开了位运算的 32 位溢出隐患。
• 需要数值统计展示或四舍五入：使用 Math.round，但若业务涉及负数且严格要求绝对值对称四舍五入（如负半数 -1.5 需舍入为 -2），应使用 Math.sign(x) * Math.round(Math.abs(x)) 进行防御性包装。

在现代 JavaScript 工程实践中，清晰的语义与类型安全远比微小的微基准性能差异更加重要。优先采用 Math 原生命名空间下的语义化 API，是构建健壮前端与服务端数值处理逻辑的最佳基石。