定義
$degreesToRadians度単位で測定された入力値をラジアンに変換します。
$degreesToRadiansの構文は次のとおりです。{ $degreesToRadians: <expression> } $degreesToRadiansは、数値に変換される有効な式であればどれでもかまいません。デフォルトでは、
$degreesToRadiansは値をdoubleとして返します。$degreesToRadiansは、<expression>が128ビットの 10 進数値に解決される限り、 128ビットの 10 進数として値を返すこともできます。式の詳細については、「式 」を参照してください。
動作
null、NaN 、+/- Infinity
引数がnullの値に解決されるか、欠落しているフィールドを参照する場合、 $degreesToRadiansはnullを返します。 引数が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 進数になります。