$ceil (切り上げ)
最終更新：2026-10-09
$ceil (切り上げ)
$ceil は、与えられた数以上の最小の整数を返します。切り上げです。ページ計算や、切り上げが必要な容量見積もり（7.5 個なら在庫 8 個が必要、など）に使われます。null または欠落した引数は null を返し、整数入力はそのまま通過します。$floor の逆で、負の数では $trunc と振る舞いが異なります。-1.2 は $ceil で -1、$trunc でも -1、$floor では -2 になります。
| カテゴリ | 数学 |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh（シェル） |
📝 構文
{ $ceil: <numeric-expression> }⚙️ パラメータ
| 数値 | 数値、または数値に解決される式。 |
|---|
戻り値：入力以上の最小の整数。null または欠落している場合は null
▶ 例
以下のコマンドをローカルの mongosh で実行してください（mongod が起動済みである必要があります）：
// $ceil: 1箱12個として箱数を切り上げ
db.orders.aggregate([
{ $project: {
boxes: { $ceil: { $divide: ['$quantity', 12] } }
} }
])出力：
{ '_id': 1, 'boxes': 1 }
{ '_id': 2, 'boxes': 2 }📌 注意事項
- 負の数では $floor と逆方向になる。$ceil(-1.2) は -1、$floor(-1.2) は -2
- 整数入力はそのまま返る
- null・欠落した引数は null を返す
🏷️ 関連タグ
💡 関連ケース
さらなる実践ケースを近日公開予定。
📚 関連チュートリアル
❓ よくある質問
Q$ceil と $floor の違いは？
A$ceil は切り上げ、$floor は切り捨てです。$ceil(-1.2) は -1、$floor(-1.2) は -2 になります。
Q$ceil は負の数をどう扱いますか？
A正の無限大方向に切り上げます。-1.2 は -1、-2.8 は -2 になります。
Q$ceil で小数点以下の桁数を指定できますか？
Aできません。$ceil は整数のみを返します。小数を残すには $round や $trunc の第 2 引数を使います。
