MongoDB 的聚合框架提供了丰富的运算符来处理文档中的数值,其中 $ceil 和 $floor 分别用于执行向上取整和向下取整操作。$ceil (ceiling) 返回大于或等于指定数值的最小整数,而 $floor 返回小于或等于该数值的最大整数。这两个运算符可以接受数字、数值表达式,甚至能够处理 Long、Double 和 Decimal128 等不同的数字类型,结果会被转换为与被操作数相同的类型。例如,对 2.3 应用 $ceil 会得到 3,对 -2.3 应用 $ceil 会得到 -2；$floor 则分别返回 2 和 -3。值得注意的是,$ceil 和 $floor 本身不会改变数值的符号,而是严格按照数学天花板与地板的定义工作。
在聚合管道中,$ceil 和 $floor 通常以 $ceil: <expression> 或 $floor: <expression> 的形式出现在 $project、$addFields、$group 等阶段。表达式可以是一个简单的字段路径,也可以是其他算术运算的结果。如果传递给它们的值为 null 或缺失,运算结果也会是 null,这一点在处理非结构化数据时需要特别留意。此外,如果参数是非数值类型(比如字符串),则会抛出错误,因此在应用前最好使用 $ifNull 或 $type 做类型检查。
基本语法与类型行为
$ceil 和 $floor 的基本语法几乎一致,唯一的区别在于舍入方向。在 $project 阶段新增一个字段时可以这样写：
{
$project: {
roundedUp: { $ceil: "$price" },
roundedDown: { $floor: "$price" }
}
}
对于 Double 类型,取整后仍然是 Double,例如 3.14 取整后得到 3.0 而非整数 3。如果需要得到严格的整数(Bson Int32 或 Int64),可以在之后使用 $toInt 或 $toLong 进行转换。这种行为在数字精度要求较高的金融计算中需要额外注意,因为 Double 的 3.0 在后续运算中可能与整数的表现略有不同。MongoDB 4.4 及以上版本对 $ceil 和 $floor 增加了对 Decimal128 的更好支持,可以精确表示十进制小数,避免了二进制浮点数的舍入误差。
当处理负数时,向上取整的含义是朝着正无穷方向移动,所以 $ceil( -2.7 ) 的结果是 -2,而 $floor( -2.7 ) 则是 -3。这与一些编程语言中向零取整的行为截然不同。如果希望直接截断小数部分(向零取整),应该使用 $trunc 运算符。$trunc 在 MongoDB 5.0 中引入,专门用于截断小数部分,例如 $trunc( -2.7 ) 返回 -2,而 $trunc( 2.7 ) 返回 2。理解这三种取整方式的差异,能够帮助开发者避免因数学语义混淆而导致的业务逻辑错误。
聚合管道中的典型应用场景
向上取整最常见的场景之一是分页计算。假设每页展示 10 条记录,总记录数为 48,计算总页数就需要使用 $ceil：
db.products.aggregate([
{ $count: "total" },
{ $project: {
totalPages: { $ceil: { $divide: ["$total", 10] } }
}}
])
该管道先统计文档总数,再用除法得到浮点数,最后通过 $ceil 确保不足一页的部分也占一整页。类似地,在库存分批处理中,如果每个箱子最多装 25 件商品,要计算需要的箱子数量,同样可以借助 $ceil 将商品总量除以 25 后向上取整。
向下取整常用于阶梯定价或积分计算。例如,用户每消费 12.5 元获得一个积分,那么对于订单金额 88.8 元,计算实际可获积分时需要先用 $divide 得到商品数量,再用 $floor 舍弃不足一个积分的部分：
db.orders.aggregate([
{ $addFields: {
points: { $floor: { $divide: ["$amount", 12.5] } }
}}
])
另外,在处理时间分组时,如果想把时间戳归并到最近的整分钟或整小时,也可以先用 $toDate 转换后再通过取整操作构造时间边界。虽然 $dateTrunc 在绝大多数情况下更直接,但在旧版本或某些定制数据格式下,$floor 配合数学运算仍然是一种可行的方案。
结合条件判断与错误处理
真实的数据集中经常出现 null 值或非数字字段,直接对这样的字段应用 $ceil 或 $floor 会导致空值传递或管道报错。为了保证管道的鲁棒性,可以使用 $cond 结合 $isNumber 或 $type 进行预先过滤。例如,仅在字段 price 是数字类型时才做向上取整,否则保留原值：
{
$addFields: {
safeCeil: {
$cond: {
if: { $isNumber: "$price" },
then: { $ceil: "$price" },
else: "$price"
}
}
}
}
如果要求更严格,还可以将 null 显式地替换为 0 再取整,避免因 null 导致后续聚合结果丢失：
{
$addFields: {
normalizedUp: { $ceil: { $ifNull: ["$price", 0] } }
}
}
当需要同时对多个字段进行取整操作时,推荐使用 $addFields 或 $project 一次性声明多个运算,而不是在多个阶段中反复处理,这样能减少计算开销。此外,如果取整操作后续还要进行分组求和或排序,$ceil 和 $floor 可以内嵌在 $group 的累计表达式内部,使管道更加紧凑。
最后需要强调的是,尽管 $ceil 和 $floor 在 MongoDB 聚合管道中看起来只是简单的运算符,但它们在数据清洗、报表导出、实时计算等环节扮演着非常重要的角色。掌握它们的类型行为、数学含义以及异常处理技巧,才能写出既正确又健壮的聚合查询。