$degreesToRadians (聚合)

本页

定义

行为
示例

定义

$degreesToRadians

将度数表示的输入值转换为弧度。

$degreesToRadians 语法如下

{ $degreesToRadians: <expression> }

$degreesToRadians 接受任何有效的表达式，其结果为数字。

默认情况下，$degreesToRadians 返回 double 类型的值。只要 <expression> 解析为 128 位十进制值，$degreesToRadians 也可以返回 128 位十进制值。

有关表达式的更多信息，请参阅表达式运算符。

行为

`null`、`NaN` 和 `+/- Infinity`

如果参数解析为 null 或引用一个缺失的字段，$degreesToRadians 返回 null。如果参数解析为 NaN，$degreesToRadians 返回 NaN。如果参数解析为负无穷或正无穷，$degreesToRadians 分别返回负无穷或正无穷。

示例	结果
`{ $degreesToRadians: NaN }`	`NaN`
`{ $degreesToRadians: null }`	`null`
`{ $degreesToRadians : Infinity}`	`Infinity`
`{ $degreesToRadians : -Infinity }`	`-Infinity`

示例

三角学集合包含一个文档，其中包含三个以度为单位测量的角度

{
  "angle_a" : NumberDecimal("53.13010235415597870314438744090659"),
  "angle_b" : NumberDecimal("36.86989764584402129685561255909341"),
  "angle_c" : NumberDecimal("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" : NumberDecimal("53.13010235415597870314438744090660"),
  "angle_b" : NumberDecimal("36.86989764584402129685561255909341"),
  "angle_c" : NumberDecimal("90"),
  "angle_a_rad" : NumberDecimal("0.9272952180016122324285124629224290"),
  "angle_b_rad" : NumberDecimal("0.6435011087932843868028092287173227"),
  "angle_c_rad" : NumberDecimal("1.570796326794896619231321691639752")
}

由于angle_a、angle_b和angle_c存储为128位十进制数，因此$degreesToRadians的输出是128位十进制数。

$dayOfYear

下一步

$denseRank

定义

行为

null、NaN 和 +/- Infinity

示例

`null`、`NaN` 和 `+/- Infinity`