$sinhDevuelve el seno hiperbólico de un valor medido en radianes.
$sinhtiene la siguiente sintaxis:{ $sinh: <expression> } $sinhacepta cualquier expresión válida que dé como resultado un número, medido en radianes. Si la expresión devuelve un valor en grados, utilice el operador para convertirlo a$degreesToRadiansradianes.Por defecto, devuelve valores
$sinhcomodoubleun. también puede$sinh128devolver valores como un decimal de bits si el se<expression>resuelve en un 128valor decimal de bits.Para obtener más información sobre las expresiones, consulta Expresiones.
Comportamiento
null, NaN, y +/- Infinity
Si el argumento de entrada se resuelve en un valor de null o hace referencia a un campo que no está presente, $sinh nulldevuelve. Si el argumento se resuelve NaN en, $sinh NaNdevuelve. Si el argumento se resuelve en negativo o Infinity positivo, devuelve negativo o$sinh positivo Infinity respectivamente.
Ejemplo | Resultados |
|---|---|
|
|
|
|
|
|
|
|
Ejemplo
La siguiente colección de trigonometry contiene un documento que almacena un valor de angle medido en grados:
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d25" ), "angle" : Decimal128( "53.1301023541559787031443874490659" ) } )
La siguiente operación de agregación utiliza la expresión para calcular el seno hiperbólico $sinh de angle y lo agrega al documento $addFields de entrada utilizando la etapa de canalización:
db.trigonometry.aggregate( [ { $addFields : { "sinh_output" : { $sinh : { $degreesToRadians : "$angle" } } } } ] )
La expresión $degreesToRadians convierte los angle en grados a radianes.
Ejemplo de salida:
{ "_id" : ObjectId("5c50782193f833234ba90d25"), "angle" : Decimal128("53.1301023541559787031443874490659"), "sinh_output" : Decimal128("1.066020404405732132503284522731829") }
Debido a angle que se almacena como un 128decimal de bits, la salida también es $sinh un 128decimal de bits.
La siguiente colección trigonometry contiene un documento que almacena un valor angle medido en radianes:
db.trigonometry.insertOne( { "_id" : ObjectId( "5c50782193f833234ba90d35" ), "angle" : Decimal128( "1.6301023541559787031443874490659" ) } )
La siguiente operación de agregación utiliza la expresión para calcular el seno hiperbólico $sinh de angle y lo agrega al documento $addFields de entrada utilizando la etapa de canalización:
db.trigonometry.aggregate( [ { $addFields : { "sinh_output" : { $sinh : "$angle" } } } ] )
Ejemplo de salida:
{ "_id" : ObjectId("5c50782193f833234ba90d35"), "angle" : Decimal128("1.6301023541559787031443874490659"), "sinh_output" : Decimal128("2.454243813557362033961729701069671") }
Debido a angle que se almacena como un 128decimal de bits, la salida también es $sinh un 128decimal de bits.