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.

# \$1add
<a name="add"></a>

L'`$add`opérateur dans Amazon DocumentDB est utilisé pour additionner des nombres ou des dates. Il peut être utilisé pour effectuer des opérations arithmétiques sur des champs numériques ou pour effectuer des opérations arithmétiques de date en ajoutant un certain nombre d'unités de temps à un champ de date.

**Paramètres**
+ `expression1`: premier chiffre ou date à ajouter.
+ `expression2`: deuxième chiffre ou date à ajouter.
+ `expression3`: (facultatif) Chiffres ou dates supplémentaires à ajouter.

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

L'exemple suivant montre comment utiliser l'`$add`opérateur pour additionner deux nombres.

**Création d'exemples de documents**

```
db.numbers.insertMany([
  { _id: 1, a: 5, b: 3 },
  { _id: 2, a: 10, b: 7 },
  { _id: 3, a: 2, b: 8 }
]);
```

**Exemple de requête**

```
db.numbers.aggregate([
  { $project: {
    _id: 1,
    sum: { $add: ["$a", "$b"] }
  }}
])
```

**Sortie**

```
[
  { "_id" : 1, "sum" : 8 },
  { "_id" : 2, "sum" : 17 },
  { "_id" : 3, "sum" : 10 }
]
```

Dans cet exemple, l'`$add`opérateur est utilisé pour ajouter les valeurs des `b` champs `a` et pour chaque document et pour stocker le résultat dans le `sum` champ.

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

Pour afficher un exemple de code relatif à l'utilisation de la `$add` commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

------
#### [ Node.js ]

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

async function example() {
  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('numbers');

  const result = await collection.aggregate([
    { $project: {
      _id: 1,
      sum: { $add: ['$a', '$b'] }
    }}
  ]).toArray();

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

example();
```

------
#### [ Python ]

```
from pymongo import MongoClient

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['numbers']

result = list(collection.aggregate([
    { '$project': {
        '_id': 1,
        'sum': { '$add': ['$a', '$b'] }
    }}
]))

print(result)
client.close()
```

------