

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 FromParts
<a name="dateFromParts"></a>

Neu ab Version 5.0.1 und 8.0

Der `$dateFromParts` Aggregationsoperator in Amazon DocumentDB erstellt einen Datums- und Uhrzeitwert aus seinen Bestandteilen, wie Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunde, und gibt ihn zurück.

**Parameter**
+ `year`: Das Kalenderjahr. Erforderlich, wenn keine Teile nach ISO 8601 verwendet werden.
+ `month`,`day`,, `hour` `minute``second`,`millisecond`: (optional) Die verbleibenden Datums- und Uhrzeitkomponenten. Ausgelassene Komponenten verwenden standardmäßig ihren niedrigsten gültigen Wert.
+ `isoWeekYear`,`isoWeek`,`isoDayOfWeek`: (optional) ISO 8601-Datumskomponenten. Verwenden Sie diese anstelle von`year`, und`month`, `day` um ein Datum aus einem ISO-8601-Wochendatum zu konstruieren.
+ `timezone`: (optional) Die Zeitzone, die bei der Erstellung des Datums verwendet werden soll. Wenn nicht angegeben, wird UTC verwendet.

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

Das folgende Beispiel zeigt, wie der `$dateFromParts` Operator verwendet wird, um ein Datum aus einzelnen Komponenten zu erstellen.

**Erstellen Sie Beispieldokumente**

```
db.parts.insertMany([
  { _id: 1, y: 2023, m: 4, d: 1 },
  { _id: 2, y: 2023, m: 12, d: 25 }
]);
```

**Beispiel für eine Abfrage**

```
db.parts.aggregate([
  {
    $project: {
      _id: 1,
      constructedDate: {
        $dateFromParts: { year: "$y", month: "$m", day: "$d" }
      }
    }
  }
])
```

**Ausgabe**

```
[
  { "_id": 1, "constructedDate": ISODate("2023-04-01T00:00:00Z") },
  { "_id": 2, "constructedDate": ISODate("2023-12-25T00:00:00Z") }
]
```

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

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

  const result = await collection.aggregate([
    {
      $project: {
        _id: 1,
        constructedDate: {
          $dateFromParts: { year: "$y", month: "$m", day: "$d" }
        }
      }
    }
  ]).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['parts']

    result = list(collection.aggregate([
        {
            '$project': {
                '_id': 1,
                'constructedDate': {
                    '$dateFromParts': { 'year': '$y', 'month': '$m', 'day': '$d' }
                }
            }
        }
    ]))

    print(result)

    client.close()

example()
```

------