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.

# \$1DateSubtrahieren
<a name="dateSubtract"></a>

Neu ab Version 5.0

Mit dem `$dateSubtract` Aggregationsoperator in Amazon DocumentDB können Sie eine angegebene Dauer von einem Datumswert subtrahieren.

**Parameter**
+ `date`: Ein Datumsausdruck, der in ein Datum oder einen Zeitstempel aufgelöst wird.
+ `subtrahend`: Ein Ausdruck für die Dauer, der angibt, wie viel Zeit vom Ausdruck abgezogen werden soll. `date`
+ `unit`: Eine Zeichenfolge, die die Zeiteinheit für den `subtrahend` Ausdruck angibt. Unterstützte Einheiten sind „Jahr“, „Quartal“, „Monat“, „Woche“, „Tag“, „Stunde“, „Minute“, „Sekunde“ und „Millisekunde“.

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

Das folgende Beispiel zeigt, wie der `$dateSubtract` Operator verwendet wird, um das Datum vor einem Jahr anhand des aktuellen Datums zu berechnen.

**Erstellen Sie Beispieldokumente**

```
db.events.insertOne({
  eventName: "Player joined",
  eventTime: ISODate("2023-04-01T12:00:00Z")
});
```

**Beispiel für eine Abfrage**

```
db.events.aggregate([
  {
    $project: {
      eventName: 1,
      oneYearAgo: {
        $dateSubtract: {
          startDate: "$eventTime",
          amount: 1,
          unit: "year"
        }
      }
    }
  }
])
```

**Ausgabe**

```
{
  "_id" : ObjectId("64567890abcdef012345678"),
  "eventName" : "Player joined",
  "oneYearAgo" : ISODate("2022-04-01T12:00:00Z")
}
```

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

Um ein Codebeispiel für die Verwendung des `$dateSubtract` 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 events = db.collection('events');

  const result = await events.aggregate([
    {
      $project: {
        eventName: 1,
        oneYearAgo: {
          $dateSubtract: {
            startDate: "$eventTime",
            amount: 1,
            unit: "year"
          }
        }
      }
    }
  ]).toArray();

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

example();
```

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

```
from pymongo import MongoClient
from bson.date_time import datetime

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

    result = list(events.aggregate([
        {
            '$project': {
                'eventName': 1,
                'oneYearAgo': {
                    '$dateSubtract': {
                        'startDate': '$eventTime',
                        'amount': 1,
                        'unit': 'year'
                    }
                }
            }
        }
    ]))

    print(result)
    client.close()

example()
```

------