$acosh(集計)
$acosh
値の逆双曲線コサイン(双曲線アーク コサイン)を返します。
$acosh
の構文は次のとおりです。{ $acosh: <expression> } $acosh
は、1
から+Infinity
までの数値に変換される有効な式であればどれでもかまいません。たとえば、1 <= value <= +Infinity
。$acosh
はラジアン単位で値を返します。$radiansToDegrees
演算子を使用して出力値をラジアンから度に変換します。デフォルトでは、
$acosh
は値をdouble
として返します。$acosh
は、<expression>
が128ビットの 10 進数値に解決される限り、 128ビットの 10 進数として値を返すこともできます。式の詳細については、「式演算子」を参照してください。
動作
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") }
x-coordinate
は128ビットの 10 進数として保存されているため、 $acosh
の出力は128ビットの 10 進数になります。
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") }
x-coordinate
は128ビットの 10 進数として保存されているため、 $acosh
の出力は128ビットの 10 進数になります。