View a markdown version of this page

$datum FromParts - Amazon DocumentDB
Beispiel (MongoDB Shell)Codebeispiele

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

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 minutesecond,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 vonyear, undmonth, 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)

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

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()