Docs Home → Develop Applications → MongoDB Manual
$cosh (aggregation)![](/docs/v4.4/assets/link.svg)
$cosh
New in version 4.2.
Returns the hyperbolic cosine of a value that is measured in radians.
$cosh
has the following syntax:{ $cosh: <expression> } $cosh
takes any valid expression that resolves to a number, measured in radians. If the expression returns a value in degrees, use the$degreesToRadians
operator to convert the value to radians.By default
$cosh
returns values as adouble
.$cosh
can also return values as a 128-bit decimal if the<expression>
resolves to a 128-bit decimal value.For more information on expressions, see Expressions.
Behavior![](/docs/v4.4/assets/link.svg)
null
, NaN
, and +/- Infinity
![](/docs/v4.4/assets/link.svg)
If the input argument resolves to a value of null
or refers to a
field that is missing, $cosh
returns null
. If the
argument resolves to NaN
, $cosh
returns NaN
. If
the argument resolves to negative or positive Infinity
,
$cosh
returns positive Infinity
.
Example | Results |
---|---|
{ $cosh: NaN } | NaN |
{ $cosh: null } | null |
{ $cosh: -Infinity } | Infinity |
{ $cosh: Infinity } | Infinity |