Di MongoDB, $degreesToRadians
operator pipeline agregasi mengonversi nilai input yang diukur dalam derajat ke radian.
$degreesToRadians
menerima ekspresi valid apa pun yang menghasilkan angka.
$degreesToRadians
operator diperkenalkan di MongoDB 4.2.
Contoh
Misalkan kita memiliki koleksi yang disebut test
dengan dokumen berikut:
{ "_id" : 1, "data" : 180 }
Dan mari kita asumsikan bahwa nilai data
bidang dalam derajat (oleh karena itu, dalam hal ini 180
derajat).
Kita dapat menggunakan $degreesToRadians
operator untuk mengonversi data
bidang ke radian:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
degrees: "$data",
radians: { $degreesToRadians: "$data" }
}
}
]
)
Hasil:
{ "degrees" : 180, "radians" : 3.141592653589793 }
Secara default, $degreesToRadians
operator mengembalikan nilai sebagai double
, tetapi juga dapat mengembalikan nilai sebagai desimal 128-bit selama ekspresi diselesaikan menjadi nilai desimal 128-bit.
Nilai Desimal 128-Bit
Jika ekspresi diberikan ke $degreesToRadians
adalah desimal 128-bit, maka hasilnya dikembalikan dalam desimal 128-bit.
Misalkan kita menambahkan dokumen berikut ke koleksi kita:
{ "_id" : 2, "data" : NumberDecimal("0.1301023541559787031443874490659") }
Mari kita jalankan $degreesToRadians
operator terhadap dokumen itu:
db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
degrees: "$data",
radians: { $degreesToRadians: "$data" }
}
}
]
).pretty()
Hasil:
{ "degrees" : NumberDecimal("90.1301023541559787031443874490659"), "radians" : NumberDecimal("1.573067041239514175890278047405623") }
Outputnya adalah desimal 128-bit.
Nilai Null
Nilai nol mengembalikan null
saat menggunakan $degreesToRadians
operator.
Misalkan kita menambahkan dokumen berikut ke koleksi kita:
{ "_id" : 3, "data" : null }
Mari kita jalankan $degreesToRadians
operator terhadap dokumen itu:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
radians: { $degreesToRadians: "$data" }
}
}
]
)
Hasil:
{ "radians" : null }
Kita dapat melihat bahwa hasilnya adalah null
.
Nilai NaN
Jika argumen diselesaikan menjadi NaN
, $degreesToRadians
mengembalikan NaN
.
Contoh:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
radians: { $degreesToRadians: 0 * "$data" }
}
}
]
)
Hasil:
{ "radians" : NaN }
Tak Terbatas
Jika argumen diselesaikan menjadi Infinity
atau -Infinity
, $degreesToRadians
operator mengembalikan Infinity
.
Misalkan kita menambahkan dokumen berikut ke koleksi kita:
{ "_id" : 4, "data" : Infinity }
Mari kita jalankan $degreesToRadians
terhadap bidang data:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
radians: { $degreesToRadians: "$data" }
}
}
]
)
Hasil:
{ "radians" : Infinity }
Bidang Tidak Ada
Jika $degreesToRadians
operator diterapkan pada bidang yang tidak ada, null
dikembalikan.
Contoh:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
radians: { $degreesToRadians: "$name" }
}
}
]
)
Hasil:
{ "radians" : null }
Dikombinasikan dengan Operator Lain
Beberapa operator pipa agregasi menerima ekspresi mereka dalam radian. Jika bidang memiliki nilai dalam derajat, Anda dapat menggabungkan $degreesToRadians
untuk mengubah ekspresi menjadi radian.
Misalkan kita memiliki koleksi yang disebut test
dengan dokumen berikut:
{ "_id" : 1, "data" : 3 }
Dan dalam hal ini, nilai bidang data dalam derajat.
Sekarang misalkan kita ingin menggunakan $cosh
operator untuk mengembalikan kosinus hiperbolik dari data
bidang. Satu-satunya masalah adalah bahwa $cosh
operator menerima ekspresi dalam radian.
Tidak masalah! Kita bisa menggunakan $degreesToRadians
untuk mengonversi ekspresi input ke radian.
Contoh:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
hyperbolicCosine: { $degreesToRadians: { $cosh: "$data" } }
}
}
]
)
Hasil:
{ "hyperbolicCosine" : 0.17571384980422547 }