$asin (aggregation)
$asin
New in version 4.2.
Returns the inverse sine (arc sine) of a value.
$asin
has the following syntax:{ $asin: <expression> } $asin
takes any valid expression that resolves to a number between-1
and1
, e.g.-1 <= value <= 1
.$asin
returns values in radians. Use$radiansToDegrees
operator to convert the output value from radians to degrees.By default
$asin
returns values as adouble
.$asin
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
If the argument resolves to a value of null
or refers to a field
that is missing, $asin
returns null
. If the
argument resolves to NaN
, $asin
returns NaN
.
If the argument resolves to a value outside the bounds of
[-1, 1]
inclusive, $asin
throws an error.
Example | Results | |||
---|---|---|---|---|
{ $asin: NaN } | NaN | |||
{ $asin: null } | null | |||
or
| Throws an error message resembling the following formatted output:
|