$ceil (aggregation)

在本页面

Definition

  • $ceil
    • 3.2 版中的新功能。

返回大于或等于指定数字的最小整数。

$ceil具有以下语法:

{ $ceil: <number> }

<number>表达式可以是任何有效的expression,只要它可以解析为数字。有关表达式的更多信息,请参见Expressions

Behavior

如果参数解析为null的值或引用了缺少的字段,则$ceil返回null。如果参数解析为NaN,则$ceil返回NaN

ExampleResults
{ $ceil: 1 }1
{ $ceil: 7.80 }8
{ $ceil: -2.8 }-2

Example

名为samples的集合包含以下文档:

{ _id: 1, value: 9.25 }
{ _id: 2, value: 8.73 }
{ _id: 3, value: 4.32 }
{ _id: 4, value: -5.34 }

以下示例返回原始值和上限值:

db.samples.aggregate([
   { $project: { value: 1, ceilingValue: { $ceil: "$value" } } }
])

该操作返回以下结果:

{ "_id" : 1, "value" : 9.25, "ceilingValue" : 10 }
{ "_id" : 2, "value" : 8.73, "ceilingValue" : 9 }
{ "_id" : 3, "value" : 4.32, "ceilingValue" : 5 }
{ "_id" : 4, "value" : -5.34, "ceilingValue" : -5 }