Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

$asinh

Nouveau depuis la version 8.0.1.

L'$asinhopérateur dans Amazon DocumentDB renvoie le sinus hyperbolique inverse d'une valeur. Utilisez-le dans le pipeline d'agrégation pour effectuer des calculs trigonométriques hyperboliques sur des champs numériques.

Paramètres

Le résultat est exprimé en radians. Pour obtenir des degrés, appliquez $radiansToDegrees à la sortie.

Le type de retour est double par défaut. Si l'entrée est une décimale de 128 bits, la sortie est également une décimale de 128 bits.

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$asinhopérateur pour calculer le sinus hyperbolique inverse des valeurs numériques.

Créez des exemples de documents

db.values.insertMany([
  { "_id": 1, "value": 0 },
  { "_id": 2, "value": 1 },
  { "_id": 3, "value": -1 }
]);

Exemple de requête

db.values.aggregate([
  { $project: {
    "result": { $asinh: "$value" }
  }}
]);

Sortie

[
  { "_id": 1, "result": 0 },
  { "_id": 2, "result": 0.881373587019543 },
  { "_id": 3, "result": -0.881373587019543 }
]

Exemples de code

Pour afficher un exemple de code d'utilisation de l'$asinhopérateur, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

Node.js

const { MongoClient } = require('mongodb');

async function main() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('values');

  const result = await collection.aggregate([
    { $project: {
      "result": { $asinh: "$value" }
    }}
  ]).toArray();

  console.log(result);
  await client.close();
}

main();

Python

from pymongo import MongoClient

def main():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    collection = db['values']

    result = list(collection.aggregate([
        { '$project': {
            'result': { '$asinh': '$value' }
        }}
    ]))

    print(result)
    client.close()

if __name__ == "__main__":
    main()