$ceil(集計)
定義
$ceil
指定した数値以上の最小の整数を返します。
$ceil
の構文は次のとおりです。{ $ceil: <number> } <number>
式は、数値に変換される限り、有効な式であれば何でも使用できます。 式の詳細については、「式演算子 」を参照してください。
動作
引数がnull
の値に解決されるか、欠落しているフィールドを参照する場合、 $ceil
はnull
を返します。 引数がNaN
に解決されると、 $ceil
はNaN
を返します。
例 | 結果 |
---|---|
{ $ceil: 1 } | 1 |
{ $ceil: 7.80 } | 8 |
{ $ceil: -2.8 } | -2 |
例
次のドキュメントを含むsamples
という名前のコレクションを作成します。
db.samples.insertMany( [ { _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 }