Docs Home → Develop Applications → MongoDB Manual
$acosh (aggregation)![](/docs/v5.2/assets/link.svg)
$acosh
New in version 4.2.
Returns the inverse hyperbolic cosine (hyperbolic arc cosine) of a value.
$acosh
has the following syntax:{ $acosh: <expression> } $acosh
takes any valid expression that resolves to a number between1
and+Infinity
, e.g.1 <= value <= +Infinity
.$acosh
returns values in radians. Use$radiansToDegrees
operator to convert the output value from radians to degrees.By default
$acosh
returns values as adouble
.$acosh
can also return values as a 128-bit decimal as long as the<expression>
resolves to a 128-bit decimal value.For more information on expressions, see Expressions.
Behavior![](/docs/v5.2/assets/link.svg)
null
, NaN
, and +/- Infinity
![](/docs/v5.2/assets/link.svg)
If the argument resolves to a value of null
or refers to a field
that is missing, $acosh
returns null
. If the argument
resolves to NaN
, $acosh
returns NaN
. If the
argument resolves to negative infinity, $acosh
throws an
error. If the argument resolves to Infinity
, $acosh
returns Infinity
. If the argument resolves to a value outside the
bounds of [-1, Infinity]
inclusive, $acosh
throws an error.
Example | Results | |||
---|---|---|---|---|
{ $acosh: NaN } | NaN | |||
{ $acosh: null } | null | |||
{ $acosh : Infinity} | Infinity | |||
{ $acosh : 0 } | Throws an error message resembling the following formatted output:
|