In MongoDB, il $ceil
l'operatore della pipeline di aggregazione restituisce il numero intero più piccolo maggiore o uguale al numero specificato.
$ceil
accetta qualsiasi espressione valida che si risolve in un numero.
Esempio
Supponiamo di avere una collezione chiamata test
con i seguenti documenti:
{ "_id" : 1, "data" : 1.5 } { "_id" : 2, "data" : 1.01 } { "_id" : 3, "data" : -1.5 } { "_id" : 4, "data" : -1.01 } { "_id" : 5, "data" : 1 }
Possiamo usare il $ceil
operatore per restituire il plafond dei data
campo:
db.test.aggregate(
[
{ $project: {
ceiling: { $ceil: "$data" }
}
}
]
)
Risultato:
{ "_id" : 1, "ceiling" : 2 } { "_id" : 2, "ceiling" : 2 } { "_id" : 3, "ceiling" : -1 } { "_id" : 4, "ceiling" : -1 } { "_id" : 5, "ceiling" : 1 }
Valori Nulli
I valori Null restituiscono null
quando si utilizza il $ceil
operatore.
Supponiamo di aggiungere il seguente documento alla nostra raccolta:
{ "_id" : 6, "data" : null }
Applichiamo il $ceil
operatore contro quel documento:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{ $project: {
ceiling: { $ceil: "$data" }
}
}
]
)
Risultato:
{ "_id" : 6, "ceiling" : null }
Possiamo vedere che il risultato è null
.
Valori NaN
Se l'argomento si risolve in NaN
, $ceil
restituisce NaN
.
Esempio:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
ceiling: { $ceil: "$data" * 1 }
}
}
]
)
Risultato:
{ "_id" : 1, "ceiling" : NaN }
Campi inesistenti
Se il $ceil
operatore viene applicato a un campo che non esiste, null
viene restituito.
Esempio:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
ceiling: { $ceil: "$age" }
}
}
]
)
Risultato:
{ "_id" : 1, "ceiling" : null }