Di MongoDB, $ceil
operator pipeline agregasi mengembalikan bilangan bulat terkecil yang lebih besar dari atau sama dengan angka yang ditentukan.
$ceil
menerima ekspresi valid apa pun yang menghasilkan angka.
Contoh
Misalkan kita memiliki koleksi yang disebut test
dengan dokumen sebagai berikut:
{ "_id" : 1, "data" : 1.5 } { "_id" : 2, "data" : 1.01 } { "_id" : 3, "data" : -1.5 } { "_id" : 4, "data" : -1.01 } { "_id" : 5, "data" : 1 }
Kita dapat menggunakan $ceil
operator untuk mengembalikan plafon data
bidang:
db.test.aggregate(
[
{ $project: {
ceiling: { $ceil: "$data" }
}
}
]
)
Hasil:
{ "_id" : 1, "ceiling" : 2 } { "_id" : 2, "ceiling" : 2 } { "_id" : 3, "ceiling" : -1 } { "_id" : 4, "ceiling" : -1 } { "_id" : 5, "ceiling" : 1 }
Nilai Null
Nilai nol mengembalikan null
saat menggunakan $ceil
operator.
Misalkan kita menambahkan dokumen berikut ke koleksi kita:
{ "_id" : 6, "data" : null }
Mari kita terapkan $ceil
operator terhadap dokumen itu:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{ $project: {
ceiling: { $ceil: "$data" }
}
}
]
)
Hasil:
{ "_id" : 6, "ceiling" : null }
Kita dapat melihat bahwa hasilnya adalah null
.
Nilai NaN
Jika argumen diselesaikan menjadi NaN
, $ceil
mengembalikan NaN
.
Contoh:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
ceiling: { $ceil: "$data" * 1 }
}
}
]
)
Hasil:
{ "_id" : 1, "ceiling" : NaN }
Bidang Tidak Ada
Jika $ceil
operator diterapkan pada bidang yang tidak ada, null
dikembalikan.
Contoh:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
ceiling: { $ceil: "$age" }
}
}
]
)
Hasil:
{ "_id" : 1, "ceiling" : null }