MongoDB $sinh

Dans MongoDB, le $sinh L'opérateur de pipeline d'agrégation renvoie le sinus hyperbolique d'une valeur mesurée en radians.

$sinh accepte toute expression valide qui se résout en un nombre.

Le $sinh L'opérateur a été introduit dans MongoDB 4.2.

Exemple

Supposons que nous ayons une collection appelée test avec le document suivant :

{ "_id" : 1, "data" : 2 }

Nous pouvons utiliser le $sinh opérateur pour retourner le sinus hyperbolique de la data champ :

db.test.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        hyperbolicSine: { $sinh: "$data" }
      }
    }
  ]
)

Résultat :

{ "hyperbolicSine" : 3.6268604078470186 }

Convertir en radians

Comme mentionné, $sinh renvoie le sinus d'une valeur mesurée en radians. Si la valeur est en degrés, vous pouvez utiliser le $degreesToRadians opérateur pour le convertir en radians.

Exemple :

db.test.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        hyperbolicSine: { $degreesToRadians: { $sinh: "$data" } }
      }
    }
  ]
)

Résultat :

{ "hyperbolicSine" : 0.06330065562715485 }

Valeurs décimales 128 bits

Par défaut, le $sinh l'opérateur renvoie les valeurs sous la forme d'un double , mais il peut également renvoyer des valeurs sous la forme d'un décimal de 128 bits tant que l'expression se résout en une valeur décimale de 128 bits.

Supposons que nous ajoutions le document suivant à notre collection :

{ "_id" : 2, "data" : NumberDecimal("2.1301023541559787031443874490659") }

Exécutons le $sinh opérateur sur ce document :

db.test.aggregate(
  [
    { $match: { _id: 2 } },
    { $project: { 
        _id: 0,
        result: { $sinh: "$data" }
      }
    }
  ]
)

Résultat :

{ "result" : NumberDecimal("4.148451510563232456419254731162938") }

La sortie est décimale 128 bits.

Valeurs nulles

Les valeurs nulles renvoient null lors de l'utilisation du $sinh opérateur.

Supposons que nous ajoutions le document suivant à notre collection :

{ "_id" : 3, "data" : null }

Exécutons le $sinh opérateur sur ce document :

db.test.aggregate(
  [
    { $match: { _id: 3 } },
    { $project: { 
        _id: 0,
        result: { $sinh: "$data" }
      }
    }
  ]
)

Résultat :

{ "result" : null }

Nous pouvons voir que le résultat est null .

Valeurs NaN

Si l'argument se résout en NaN , $sinh renvoie NaN .

Exemple :

db.test.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        result: { $sinh: 1 * "$data" }
      }
    }
  ]
)

Résultat :

{ "result" : NaN }

Champs inexistants

Si le $sinh l'opérateur est appliqué sur un champ qui n'existe pas, null est renvoyé.

Exemple :

db.test.aggregate(
  [
    { $match: { _id: 1 } },
    { $project: { 
        _id: 0,
        result: { $sinh: "$name" }
      }
    }
  ]
)

Résultat :

{ "result" : null }

Infini

Fournir Infinity renvoie Infinity , et fournissant -Infinity renvoie -Infinity .

Supposons que nous ajoutions les documents suivants à la collection :

{ "_id" : 4, "data" : Infinity }
{ "_id" : 5, "data" : -Infinity }

Appliquons $sinh à ces documents :

db.test.aggregate(
  [
    { $match: { _id: { $in: [ 4, 5 ] } } },
    { $project: { 
        hyperbolicSine: { $sinh: "$data" }
      }
    }
  ]
)

Résultat :

{ "_id" : 4, "hyperbolicSine" : Infinity }
{ "_id" : 5, "hyperbolicSine" : -Infinity }