$sinhRetorna o seno hiperbólico de um valor medido em radianos.
$sinhtem a seguinte sintaxe:{ $sinh: <expression> } $sinhtakes any valid expression that resolves to a number, measured in radians. If the expression returns a value in degrees, use the$degreesToRadiansoperator to convert the value to radians.By default
$sinhreturns values as adouble.$sinhcan also return values as a 128-bit decimal if the<expression>resolves to a 128-bit decimal value.Para mais informações sobre expressões, consulte Expressões.
Comportamento
null, NaN e +/- Infinity
If the input argument resolves to a value of null or refers to a field that is missing, $sinh returns null. If the argument resolves to NaN, $sinh returns NaN. If the argument resolves to negative or positive Infinity, $sinh returns negative or positive Infinity respectively.
Exemplo | Resultados |
|---|---|
|
|
|
|
|
|
|
|
Exemplo
A seguinte collection do trigonometry contém um documento que armazena um valor do angle medido em graus:
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d25" ), "angle" : Decimal128( "53.1301023541559787031443874490659" ) } )
The following aggregation operation uses the $sinh expression to calculate the hyperbolic sine of angle and adds it to the input document using the $addFields pipeline stage:
db.trigonometry.aggregate( [ { $addFields : { "sinh_output" : { $sinh : { $degreesToRadians : "$angle" } } } } ] )
A expressão $degreesToRadians converte o angle de graus para radianos.
Saída de exemplo:
{ "_id" : ObjectId("5c50782193f833234ba90d25"), "angle" : Decimal128("53.1301023541559787031443874490659"), "sinh_output" : Decimal128("1.066020404405732132503284522731829") }
Because angle is stored as a 128-bit decimal, the $sinh output is also a 128-bit decimal.
A seguinte coleção trigonometry contém um documento que armazena um valor angle medido em radianos:
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d35" ), "angle" : Decimal128( "1.6301023541559787031443874490659" ) } )
The following aggregation operation uses the $sinh expression to calculate the hyperbolic sine of angle and adds it to the input document using the $addFields pipeline stage:
db.trigonometry.aggregate( [ { $addFields : { "sinh_output" : { $sinh : "$angle" } } } ] )
Saída de exemplo:
{ "_id" : ObjectId("5c50782193f833234ba90d35"), "angle" : Decimal128("1.6301023541559787031443874490659"), "sinh_output" : Decimal128("2.454243813557362033961729701069671") }
Because angle is stored as a 128-bit decimal, the $sinh output is also a 128-bit decimal.