/ /

$sinh (operador de expresión)

$sinh

Devuelve el seno hiperbólico de un valor medido en radianes.

$sinh tiene la siguiente sintaxis:

{ $sinh: <expression> }

$sinh takes any valid Expresión que se resuelve en un número, medido en radianes. Si la expresión devuelve un valor en grados, utilice el operador $degreesToRadians para convertir el valor a radianes.

Por defecto, $sinh devuelve valores como un double. $sinh también puede devolver valores como un Decimal de128-bit si el <expression> se resuelve en un valor decimal de 128bits.

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 se refiere a un campo que falta, $sinh devuelve null. Si el argumento se resuelve como NaN, $sinh devuelve NaN. Si el argumento se resuelve como negativo o positivo Infinity, $sinh devuelve Infinity negativo o positivo, respectivamente.

Ejemplo	Resultados
`{ $sinh: NaN }`	`NaN`
`{ $sinh: null }`	`null`
`{ $sinh: -Infinity }`	`-Infinity`
`{ $sinh: Infinity }`	`Infinity`

Ejemplo

La siguiente colección trigonometry contiene un documento que almacena un valor 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 $sinh para calcular el seno hiperbólico de angle y lo añade al documento de entrada utilizando la etapa de pipeline $addFields:

db.trigonometry.aggregate( [
   {
      $addFields : {
         "sinh_output" : { $sinh : { $degreesToRadians : "$angle" } }
      }
   }
] )

La expresión convierte $degreesToRadians los angle en grados a radianes.

Ejemplo de salida:

{
   "_id" : ObjectId("5c50782193f833234ba90d25"),
   "angle" : Decimal128("53.1301023541559787031443874490659"),
   "sinh_output" : Decimal128("1.066020404405732132503284522731829")
}

Como angle se almacena como un decimal de128bits, la salida del $sinh también es un decimal de 128bits.

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 $sinh para calcular el seno hiperbólico de angle y lo añade al documento de entrada utilizando la etapa de pipeline $addFields:

db.trigonometry.aggregate( [
   {
      $addFields : {
         "sinh_output" : { $sinh : "$angle" }
      }
   }
] )

Ejemplo de salida:

{
   "_id" : ObjectId("5c50782193f833234ba90d35"),
   "angle" : Decimal128("1.6301023541559787031443874490659"),
   "sinh_output" : Decimal128("2.454243813557362033961729701069671")
}

Como angle se almacena como un decimal de128bits, la salida del $sinh también es un decimal de 128bits.

Volver

$sin

$slice

Comportamiento

null; NaN, y +/- Infinity

Ejemplo

`null`; `NaN`, y `+/- Infinity`