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.

# $atan2
<a name="atan2"></a>

Nouveau depuis la version 8.0.1.

L'`$atan2`opérateur dans Amazon DocumentDB renvoie la tangente inverse (arc tangente) de`y / x`, où `y` et `x` sont les première et deuxième valeurs transmises à l'expression respectivement.

Les deux expressions doivent être résolues en valeurs numériques. L'opérateur utilise le signe des deux arguments pour déterminer le quadrant correct.

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 les entrées sont des décimales de 128 bits, la sortie est également une décimale de 128 bits.

**Paramètres**
+ `expression 1`(y) : expression qui se résout en un nombre représentant la coordonnée y.
+ `expression 2`(x) : expression qui se résout en un nombre représentant la coordonnée X.

## Comportement
<a name="atan2-behavior"></a>

**null et NaN **

Si l'un des arguments est `null` (ou fait référence à un champ manquant), le résultat est`null`. Si l'un des arguments l'est`NaN`, le résultat est`NaN`. Lorsque l'un des arguments l'est `null` et que l'autre l'est`NaN`, `null` a la priorité.


| Exemple | Résultats | 
| --- | --- | 
| { $atan2: [ NaN, <value> ] } | NaN | 
| { $atan2: [ <value>, NaN ] } | NaN | 
| { $atan2: [ null, <value> ] } | null | 
| { $atan2: [ <value>, null ] } | null | 
| { $atan2: [ NaN, null ] } | null | 
| { $atan2: [ null, NaN ] } | null | 

## Exemple (MongoDB Shell)
<a name="atan2-examples"></a>

L'exemple suivant montre comment utiliser l'`$atan2`opérateur pour calculer l'arctangente de y/x pour un ensemble de points.

**Créez des exemples de documents **

```
db.points.insertMany([
  { "_id": 1, "y": 1, "x": 1 },
  { "_id": 2, "y": 1, "x": 0 },
  { "_id": 3, "y": -1, "x": -1 }
]);
```

**Exemple de requête **

```
db.points.aggregate([
  { $project: {
    "angle": { $atan2: ["$y", "$x"] }
  }}
]);
```

**Sortie**

```
[
  { "_id": 1, "angle": 0.7853981633974483 },
  { "_id": 2, "angle": 1.5707963267948966 },
  { "_id": 3, "angle": -2.356194490192345 }
]
```

## Exemples de code
<a name="atan2-code"></a>

Pour afficher un exemple de code d'utilisation de l'`$atan2`opé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('points');

  const result = await collection.aggregate([
    { $project: {
      "angle": { $atan2: ["$y", "$x"] }
    }}
  ]).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['points']

    result = list(collection.aggregate([
        { '$project': {
            'angle': { '$atan2': ['$y', '$x'] }
        }}
    ]))

    print(result)
    client.close()

if __name__ == "__main__":
    main()
```

------