$acosh(聚合)
$acosh
返回数值的反双曲余弦(双曲弧余弦)值。
$acosh
通过以下语法实现:{ $acosh: <expression> } $acosh
接受解析为1
和+Infinity
之间数字的任何有效表达式,例如1 <= value <= +Infinity
。$acosh
以弧度为单位返回值。使用$radiansToDegrees
操作符,将输出值从弧度转换为度数。默认情况下,
$acosh
会以double
的形式返回值。只要<expression>
解析为 128 位十进制值,$acosh
也会返回 128 位十进制值。有关表达式的更多信息,请参阅表达式运算符。
行为
null
、NaN
和+/- Infinity
如果参数解析为 null
值或引用了缺失的字段,$acosh
将返回 null
。如果参数解析为 NaN
,$acosh
将返回 NaN
。如果参数解析为负无穷大,$acosh
将返回错误。如果参数解析为 Infinity
,$acosh
将返回 Infinity
。如果参数解析为超出 [-1, Infinity]
范围的值,$acosh
将返回错误。
例子 | 结果 | |||
---|---|---|---|---|
{ $acosh: NaN } | NaN | |||
{ $acosh: null } | null | |||
{ $acosh : Infinity} | Infinity | |||
{ $acosh : 0 } | 抛出一条类似以下格式化输出的错误消息:
|
例子
trigonometry
集合包含一个文档,该文档沿 2-D 图的 x
轴存储值:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "x-coordinate" : NumberDecimal("3") }
以下聚合操作使用$acosh
表达式计算x-coordinate
的反双曲余弦,并使用$addFields
管道阶段将其添加到输入文档。
db.trigonometry.aggregate([ { $addFields : { "y-coordinate" : { $radiansToDegrees : { $acosh : "$x-coordinate" } } } } ])
$radiansToDegrees
表达式将$acosh
返回的弧度值转换为以度为单位的等效值。
该命令返回以下输出:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "x-coordinate" : NumberDecimal("3"), "y-coordinate" : NumberDecimal("100.9979734210524228844295260083432") }
trigonometry
集合包含一个文档,该文档沿 2-D 图的 x
轴存储值:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "x-coordinate" : NumberDecimal("3") }
以下聚合操作使用$acosh
表达式计算x-coordinate
的反双曲余弦,并使用$addFields
管道阶段将其添加到输入文档。
db.trigonometry.aggregate([ { $addFields : { "y-coordinate" : { $acosh : "$x-coordinate" } } } ])
该命令返回以下输出:
{ "_id" : ObjectId("5c50782193f833234ba90d85"), "x-coordinate" : NumberDecimal("3"), "y-coordinate" : NumberDecimal("1.762747174039086050465218649959585") }