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.

# \$1 bis Datum
<a name="toDate"></a>

Neu ab Version 4.0

Der `$toDate` Aggregationsoperator in Amazon DocumentDB wird verwendet, um eine Datums- oder Datums- und Uhrzeitzeichenfolge in einen BSON-Datumstyp zu konvertieren. Dies ist die umgekehrte Operation des Operators. `$dateToString`

**Parameter**
+ `dateString`: Eine Zeichenkettendarstellung eines Datums oder eines Datums und einer Uhrzeit, das in einen BSON-Datumstyp konvertiert werden soll.
+ `format`: (optional) Eine Zeichenfolge, die das Format von angibt. `dateString` Falls nicht angegeben, versucht der Operator, das `dateString` in verschiedenen standardmäßigen Datums- und Uhrzeitformaten zu analysieren.
+ `timezone`: (optional) Eine Zeichenfolge, die die Zeitzone darstellt, die für die Konvertierung verwendet werden soll. Falls nicht angegeben, wird die lokale Zeitzone verwendet.

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

Das folgende Beispiel zeigt, wie der `$toDate` Operator verwendet wird, um eine Datumszeichenfolge in einen BSON-Datumstyp zu konvertieren.

**Erstellen Sie Beispieldokumente**

```
db.events.insertMany([
  { _id: 1, eventName: "Mission Start", eventTime: "2023-04-15T10:30:00Z" },
  { _id: 2, eventName: "Checkpoint Reached", eventTime: "2023-04-15T11:15:00Z" },
  { _id: 3, eventName: "Mission End", eventTime: "2023-04-15T12:00:00Z" }
]);
```

**Beispiel für eine Abfrage**

```
db.events.aggregate([
  {
    $project: {
      eventName: 1,
      eventTimeDate: { $toDate: "$eventTime" }
    }
  }
]);
```

**Ausgabe**

```
[
  {
    "_id": 1,
    "eventName": "Mission Start",
    "eventTimeDate": ISODate("2023-04-15T10:30:00Z")
  },
  {
    "_id": 2,
    "eventName": "Checkpoint Reached",
    "eventTimeDate": ISODate("2023-04-15T11:15:00Z")
  },
  {
    "_id": 3,
    "eventName": "Mission End",
    "eventTimeDate": ISODate("2023-04-15T12:00:00Z")
  }
]
```

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

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

  const result = await collection.aggregate([
    {
      $project: {
        eventName: 1,
        eventTimeDate: { $toDate: '$eventTime' }
      }
    }
  ]).toArray();

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

example();
```

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

```
from pymongo import MongoClient

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']
    collection = db['events']

    result = list(collection.aggregate([
        {
            '$project': {
                'eventName': 1,
                'eventTimeDate': { '$toDate': '$eventTime' }
            }
        }
    ]))

    print(result)
    client.close()

example()
```

------