No MongoDB, o
$ceil
operador de pipeline de agregação retorna o menor inteiro maior ou igual ao número especificado. $ceil
aceita qualquer expressão válida que resolva para um número. Exemplo
Suponha que tenhamos uma coleção chamada
test
com os seguintes documentos:{ "_id" : 1, "data" : 1.5 } { "_id" : 2, "data" : 1.01 } { "_id" : 3, "data" : -1.5 } { "_id" : 4, "data" : -1.01 } { "_id" : 5, "data" : 1 }
Podemos usar o
$ceil
operador para retornar o teto dos data
campo:db.test.aggregate(
[
{ $project: {
ceiling: { $ceil: "$data" }
}
}
]
)
Resultado:
{ "_id" : 1, "ceiling" : 2 } { "_id" : 2, "ceiling" : 2 } { "_id" : 3, "ceiling" : -1 } { "_id" : 4, "ceiling" : -1 } { "_id" : 5, "ceiling" : 1 }
Valores nulos
Valores nulos retornam
null
ao usar o $ceil
operador. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 6, "data" : null }
Vamos aplicar o
$ceil
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{ $project: {
ceiling: { $ceil: "$data" }
}
}
]
)
Resultado:
{ "_id" : 6, "ceiling" : null }
Podemos ver que o resultado é
null
. Valores NaN
Se o argumento resolver para
NaN
, $ceil
retorna NaN
. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
ceiling: { $ceil: "$data" * 1 }
}
}
]
)
Resultado:
{ "_id" : 1, "ceiling" : NaN }
Campos inexistentes
Se o
$ceil
operador é aplicado em um campo que não existe, null
é devolvido. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
ceiling: { $ceil: "$age" }
}
}
]
)
Resultado:
{ "_id" : 1, "ceiling" : null }