$round（四舍五入）
最后更新：2026-10-09
$round（四舍五入）
$round对数值四舍五入，可指定保留小数位，接受两个参数：数值与可选的位置参数。位置为0或不传时取整，正数表示保留小数位，负数表示取整到十位、百位。常用于金额、评分等需要规范显示的场景。注意小数位恰为5时向远离零的方向取整（2.5得3，-2.5得-3），与$trunc的差异只在负数与.5边界上体现。null或缺失参数返回null。
| 分类 | 数学 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $round: [ <数值>, <位置> ] }⚙️ 参数
| 数值 | 数值或解析为数值的表达式。 |
|---|---|
| 位置 | 可选，保留的小数位；0或不传表示取整，负数取整到十位及以上。 |
返回值：四舍五入后的数值；null或缺失时返回null
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $round：金额保留两位小数
db.orders.aggregate([
{ $project: {
rounded: { $round: ['$price', 2] }
} }
])运行结果：
{ '_id': 1, 'rounded': 19.99 }
{ '_id': 2, 'rounded': 12.35 }📌 注意事项
- .5边界向远离零方向取整，-2.5得-3
- 位置为负时取整到十位百位，如$round: [123, -1]得120
- 与$trunc相比，负数小数部分$round会进位而$trunc直接截断
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q$round和$trunc有什么区别？
A$round四舍五入（.5远离零），$trunc直接向零截断，负数时差异明显。
Q$round怎么取整到十位？
A位置传-1，如$round: [123, -1]得到120。
Q$round对-2.5返回什么？
A返回-3，.5边界向远离零的方向取整。
