$cosh (operador de expresión)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

$cosh

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

$cosh tiene la siguiente sintaxis:

{ $cosh: <expression> }

$cosh toma cualquier válido Expresión que se resuelve en un número, medido en radianes. Si la expresión devuelve un valor en grados, utilice el operador para convertir el valor a $degreesToRadians radianes.

De forma predeterminada, $coshdevuelve valores como double. $coshtambién puede devolver valores como un decimal de128bits si <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 hace referencia a un campo faltante, $cosh nulldevuelve. Si se resuelve NaN en, $cosh NaNdevuelve. Si se resuelve en un valor negativo o positivo Infinity de, devuelve$cosh un valor positivo Infinity de.

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

Ejemplo

La siguiente colección trigonometry contiene un documento que almacena un valor angle medido en grados:

db.trigonometry.insertOne(
   {
      "_id" : ObjectId( "5c50782193f833234ba90d85" ),
      "angle" : Decimal128( "53.1301023541559787031443874490659" )
   }
)

La siguiente operación de agregación utiliza la expresión para calcular el coseno hiperbólico $cosh de angle y lo agrega al documento $addFields de entrada utilizando la etapa de canalización:

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

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

Ejemplo de salida:

{
   "_id" : ObjectId("5c50782193f833234ba90d85"),
   "angle" : Decimal128("53.1301023541559787031443874490659"),
   "cosh_output" : Decimal128("1.461642741099671277595921778079396")
}

Dado que angle se almacena como un 128decimal de bits, la salida también es $cosh 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( "5c50782193f833234ba90d15" ),
      "angle" : Decimal128( "1.6301023541559787031443874490659" )
   }
)

db.trigonometry.aggregate( [
   {
      $addFields : {
         "cosh_output" : { $cosh : "$angle" }
      }
   }
] )

Ejemplo de salida:

{
   "_id" : ObjectId("5c50782193f833234ba90d15"),
   "angle" : Decimal128("1.6301023541559787031443874490659"),
   "cosh_output" : Decimal128("2.650153334504361016712328539738000")
}

Dado que angle se almacena como un 128decimal de bits, la salida también es $cosh un 128decimal de bits.

Volver

$cos

$acumulador de conteo

Comportamiento

null, NaN y +/- Infinity

Ejemplo

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