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.

$bronzage

Nouveau depuis la version 8.0.1.

L'$tanopérateur dans Amazon DocumentDB renvoie la tangente d'une valeur mesurée en radians.

L'expression d'entrée doit être résolue en une valeur numérique. Si votre valeur est exprimée en degrés, appliquez-la $degreesToRadians avant de la transmettre à$tan.

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.

Paramètres

Comportement

null, NaN et +/- Infinity

Lorsque l'entrée existe null ou que le champ référencé est absent, $tan renvoienull. Une entrée de NaN produitsNaN. L'infini positif ou négatif provoque une erreur car la tangente n'est pas définie à ces valeurs.

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$tanopérateur pour calculer la tangente d'un angle en radians.

Créez des exemples de documents

db.angles.insertMany([
  { "_id": 1, "angle": 0 },
  { "_id": 2, "angle": 0.7853981633974483 },
  { "_id": 3, "angle": -0.7853981633974483 }
]);

Exemple de requête

db.angles.aggregate([
  { $project: {
    "tangent": { $tan: "$angle" }
  }}
]);

Sortie

[
  { "_id": 1, "tangent": 0 },
  { "_id": 2, "tangent": 0.9999999999999999 },
  { "_id": 3, "tangent": -0.9999999999999999 }
]

Exemples de code

Pour afficher un exemple de code d'utilisation de l'$tanopé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('angles');

  const result = await collection.aggregate([
    { $project: {
      "tangent": { $tan: "$angle" }
    }}
  ]).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['angles']

    result = list(collection.aggregate([
        { '$project': {
            'tangent': { '$tan': '$angle' }
        }}
    ]))

    print(result)
    client.close()

if __name__ == "__main__":
    main()