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.

# $datum ToParts
<a name="dateToParts"></a>

Neu ab Version 5.0.1 und 8.0

Der `$dateToParts` Aggregationsoperator in Amazon DocumentDB gibt ein Dokument zurück, das die Bestandteile eines Datums- und Uhrzeitwerts enthält, z. B. Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunde.

**Parameter**
+ `date`: Der Datums- und Uhrzeitwert, der in Teile aufgeteilt werden soll.
+ `timezone`: (optional) Die Zeitzone, die beim Extrahieren der Datumsteile verwendet werden soll. Wenn nicht angegeben, werden die Teile in UTC zurückgegeben.
+ `iso8601`: (optional) Wenn auf gesetzt`true`, verwendet das zurückgegebene Dokument ISO-8601-Datumsteile (`isoWeekYear`,`isoWeek`,`isoDayOfWeek`). Der Standardwert ist `false`.

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

Das folgende Beispiel zeigt, wie der `$dateToParts` Operator verwendet wird, um die einzelnen Teile eines Datums zurückzugeben.

**Erstellen Sie Beispieldokumente**

```
db.events.insertMany([
  { _id: 1, eventDate: ISODate("2023-04-01T10:30:15Z") },
  { _id: 2, eventDate: ISODate("2023-12-25T18:45:00Z") }
]);
```

**Beispiel für eine Abfrage**

```
db.events.aggregate([
  {
    $project: {
      _id: 1,
      parts: { $dateToParts: { date: "$eventDate" } }
    }
  }
])
```

**Ausgabe**

```
[
  {
    "_id": 1,
    "parts": { "year": 2023, "month": 4, "day": 1, "hour": 10, "minute": 30, "second": 15, "millisecond": 0 }
  },
  {
    "_id": 2,
    "parts": { "year": 2023, "month": 12, "day": 25, "hour": 18, "minute": 45, "second": 0, "millisecond": 0 }
  }
]
```

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

Um ein Codebeispiel für die Verwendung des `$dateToParts` 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: {
        _id: 1,
        parts: { $dateToParts: { date: "$eventDate" } }
      }
    }
  ]).toArray();

  console.log(result);

  await 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': {
                '_id': 1,
                'parts': { '$dateToParts': { 'date': '$eventDate' } }
            }
        }
    ]))

    print(result)

    client.close()

example()
```

------