$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 expresión siempre que se resuelva a un número. Para obtener más información sobre las expresiones, consulta 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 }