MongoDB聚合运算符：$cosh

$cosh聚合运算符用来计算双曲余弦值，返回指定表达式的双曲余弦值。

语法

{ $cosh: <expression> }

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

使用

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

示例	结果
{ $cosh: NaN }	NaN
{ $cosh: null }	null
{ $cosh: 正无穷 }	正无穷
{ $cosh: 负无穷 }	正无穷

举例

双曲余弦值角度

trigonometry集合中有下面的文档，包含了以度为单位的角度值：

db.trigonometry.insertOne({"_id" : ObjectId( "5c50782193f833234ba90d85" ),"angle" : NumberDecimal( "53.1301023541559787031443874490659" )}
)

下面的聚合操作使用$radiansToDegrees运算符将angle转换为度数，使用$cosh表达式计算双曲余弦值，然后，最后使用$addFields管道阶段将其添加到输入文档。

db.trigonometry.aggregate( [{$addFields : {"cosh_output" : { $cosh : { $degreesToRadians : "$angle" } }}}
] )

执行的结果为：

{"_id" : ObjectId("5c50782193f833234ba90d85"),"angle" : NumberDecimal("53.1301023541559787031443874490659"),"cosh_output" : NumberDecimal("1.461642741099671277595921778079396")
}

双曲余弦值弧度

trigonometry集合中有下面的文档，包含了以弧度为单位的角度值：

db.trigonometry.insertOne({"_id" : ObjectId( "5c50782193f833234ba90d15" ),"angle" : NumberDecimal( "1.6301023541559787031443874490659" )}
)

下面的聚合操作使用$cosh表达式计算angle的双曲余弦，然后使用$addFields管道阶段将其添加到输入文档。

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

结果为：

{"_id" : ObjectId("5c50782193f833234ba90d15"),"angle" : NumberDecimal("1.6301023541559787031443874490659"),"cosh_output" : NumberDecimal("2.650153334504361016712328539738000")
}