$ceil (operador de expresión)

Definición

$ceil

Devuelve el menor número entero que sea mayor o igual al número especificado.

$ceil tiene la siguiente sintaxis:

{ $ceil: <number> }

La expresión <number> puede ser cualquier expresión válida siempre que se resuelva en un número. Para obtener más información sobre las expresiones, consulte Expresiones.

Comportamiento

Si el argumento se resuelve en un valor de null o se refiere a un campo que falta, $ceil devuelve null. Si el argumento se resuelve en NaN, $ceil devuelve NaN.

Ejemplo

Cree una colección llamada samples con los siguientes documentos:

db.samples.insertMany(
   [
      { _id: 1, value: 9.25 },
      { _id: 2, value: 8.73 },
      { _id: 3, value: 4.32 },
      { _id: 4, value: -5.34 }
   ]
)

El siguiente ejemplo devuelve tanto el valor original como el valor máximo:

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

La operación devuelve los siguientes resultados:

{ "_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 }