$ceil (agregação)

Definição

$ceil

Retorna o menor número inteiro maior ou igual ao número especificado.

$ceil tem a seguinte sintaxe:

{ $ceil: <number> }

A expressão <number> pode ser qualquerexpressão válida, desde que seja resolvida como um número. Para obter mais informações sobre expressões, consulte Operadores de expressão.

Comportamento

Se o argumento for resolvido para um valor de null ou se referir a um campo ausente, $ceil retornará null. Se o argumento se resolve em NaN, $ceil retorna NaN.

Exemplo

Crie uma coleção denominada samples com os seguintes documentos:

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

O exemplo a seguir retorna o valor original e o valor do teto:

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

A operação retorna os seguintes 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 }