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位小数。