MongoDB聚合运算符：$tan

MongoDB聚合运算符：$tan

$tan用来计算正切，返回指定弧度的正切值。从MongoDB4.2版本开始支持。

语法

{ $tan: <expression> }

• <expression>为可被解析为数值的表达式，如果表达式返回以度为单位的值，应使用$DegreesToRadians运算符将其转换为弧度。
• $tan默认返回双精度数double，如果表达式<expression>解析为128-bit decimal则返回同样类型。

使用

如果参数解析为null或引用不存在的字段，则结果返回null，如果参数解析为NaN，如果参数解析为负无穷大或正无穷大，则抛出错误，如下表所示：

示例	结果
{ $tan: NaN }	NaN
{ $tan: null }	null
$tan : Infinity	抛出异常
{ $tan : -Infinity }	抛出异常

举例

正切角度

trigonometry集合中有下面的文档，包含了直角三角形的一条边和一个角：

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "angle_a" : NumberDecimal("53.13010235415597870314438744090659"),
  "side_a" : NumberDecimal("3")
}

下面的聚合操作使用$tan表达式计算与angle_a相对的正切，然后使用$addFields管道阶段将其添加到输入文档。

db.trigonometry.aggregate([
  {
    $addFields : {
      "side_b" : {
        $multiply : [
          { $tan : {$degreesToRadians : "$angle_a"} },
          "$side_a"
        ]
      }
    }
  }
])

$degsToRadians表达式将angle_a的角度值转换为弧度值。

执行的结果为：

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "angle_a" : NumberDecimal("53.13010235415597870314438744090659"),
  "side_a" : NumberDecimal("3")
  "side_b" : NumberDecimal(4.000000000000000000000000000000000")
}

由于angle_a和side_a存储为128位小数，因此$tan的输出是128位小数。

正切弧度

trigonometry集合中有下面的文档，包含了直角三角形的斜边和一个角的信息：

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "angle_a" : NumberDecimal("0.9272952180016122324285124629224288"),
  "side_a" : NumberDecimal("3")
}

以下聚合操作使用$tan表达式来计算与angle_a相邻的边，并使用$addFields管道阶段将其添加到输入文档：

db.trigonometry.aggregate([
  {
    $addFields : {
      "side_b" : {
        $multiply : [
          { $tan : "$angle_a" },
          "$side_a"
        ]
      }
    }
  }
])

结果为：

{
  "_id" : ObjectId("5c50782193f833234ba90d85"),
  "angle_a" : NumberDecimal("0.9272952180016122324285124629224288"),
  "side_a" : NumberDecimal("3"),
  "side_b" : NumberDecimal("3.999999999999999999999999999999999")
}

由于angle_a和side_a为128位小数，因此$tan的输出是128位小数。