Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Der `$add` Operator in Amazon DocumentDB wird verwendet, um Zahlen oder Daten zu addieren. Er kann verwendet werden, um arithmetische Operationen an numerischen Feldern durchzuführen oder um Datumsarithmetik durchzuführen, indem einem Datumsfeld eine Anzahl von Zeiteinheiten hinzugefügt wird.

**Parameter**
+ `expression1`: Die erste Zahl oder das erste Datum, das hinzugefügt werden soll.
+ `expression2`: Die zweite Zahl oder das zweite Datum, das hinzugefügt werden soll.
+ `expression3`: (optional) Zusätzliche Zahlen oder Daten, die hinzugefügt werden sollen.

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

Das folgende Beispiel zeigt, wie der `$add` Operator verwendet wird, um zwei Zahlen zu addieren.

**Erstellen Sie Beispieldokumente**

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

**Beispiel für eine Abfrage**

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

**Ausgabe**

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

In diesem Beispiel wird der `$add` Operator verwendet, um die Werte der `b` Felder `a` und für jedes Dokument hinzuzufügen und das Ergebnis im `sum` Feld zu speichern.

## Codebeispiele
<a name="add-code"></a>

Um ein Codebeispiel für die Verwendung des `$add` Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

------
#### [ 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()
```

------