定義
$degreesToRadians度単位で測定された入力値をラジアンに変換します。
$degreesToRadiansの構文は次のとおりです。{ $degreesToRadians: <expression> } $degreesToRadiansは、数値に変換される有効な式であればどれでもかまいません。$degreesToRadiansデフォルトでは、 は値をdoubleとして返します。$degreesToRadians128<expression>は、 が128 ビットの 10 進数値に解決される限り、 ビットの 10 進数として値を返すこともできます。式の詳細については、「式 」を参照してください。
動作
null、NaN 、+/- Infinity
引数が の値に解決されるか、欠落しているフィールドを参照する場合、null $degreesToRadiansnullは を返します。引数がNaN に解決されると、$degreesToRadians はNaN を返します。引数が負の無限大または正の無限大に解決される場合、それぞれ$degreesToRadians 負の無限大または正の無限大になります。
例 | 結果 |
|---|---|
|
|
|
|
|
|
|
|
例
trigonometryコレクションには、度単位で測定された 3 つの角度を含むドキュメントが含まれています。
{ "angle_a" : Decimal128("53.13010235415597870314438744090659"), "angle_b" : Decimal128("36.86989764584402129685561255909341"), "angle_c" : Decimal128("90") }
次の集計操作では、$degreesToRadians 式を使用して各値をラジアンに変換し、$addFields パイプラインステージを使用して入力ドキュメントに追加します。
db.trigonometry.aggregate([ { $addFields: { "angle_a_rad" : { $degreesToRadians : "$angle_a"}, "angle_b_rad" : { $degreesToRadians : "$angle_b"}, "angle_c_rad" : { $degreesToRadians : "$angle_c"} } } ])
この操作を実行すると次のドキュメントが返されます。
{ "_id" : ObjectId("5c50aec71c75c59232b3ede4"), "angle_a" : Decimal128("53.13010235415597870314438744090660"), "angle_b" : Decimal128("36.86989764584402129685561255909341"), "angle_c" : Decimal128("90"), "angle_a_rad" : Decimal128("0.9272952180016122324285124629224290"), "angle_b_rad" : Decimal128("0.6435011087932843868028092287173227"), "angle_c_rad" : Decimal128("1.570796326794896619231321691639752") }
、angle_a angle_b、 はangle_c 128ビットの 10 $degreesToRadians進数として保存されているため、 の出力は128 ビットの 10 進数になります。