$sin (aggregation)¶
On this page
Definition¶
$sin
¶New in version 4.2.
Returns the sine of a value that is measured in radians.
$sin
has the following syntax:{ $sin: <expression> } $sin
takes any valid expression that resolves to a number. If the expression returns a value in degrees, use the$degreesToRadians
operator to convert the result to radians.By default
$sin
returns values as adouble
.$sin
can also return values as a 128bit decimal as long as the<expression>
resolves to a 128bit decimal value.For more information on expressions, see Expressions.
Behavior¶
null
, NaN
, and +/ Infinity
¶
If the argument resolves to a value of null
or refers to a field
that is missing, $sin
returns null
. If the
argument resolves to NaN
, $sin
returns NaN
.
If the argument resolves to negative or positive infinity,
$sin
throws an error.
Example  Results  

{ $sin: NaN }  NaN  
{ $sin: null }  null  
or
 Throws an error message resembling the following formatted output:
