View a markdown version of this page

$ date FromParts - Amazon DocumentDB
Exemple (MongoDB Shell)Exemples de code

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

$ date FromParts

Nouveau depuis les versions 5.0.1 et 8.0

L'opérateur d'$dateFromPartsagrégation dans Amazon DocumentDB construit et renvoie une valeur de date et d'heure à partir de ses éléments constitutifs, tels que l'année, le mois, le jour, l'heure, la minute, la seconde et la milliseconde.

Paramètres

  • year: L'année civile. Obligatoire lorsque vous n'utilisez pas de pièces ISO 8601.

  • month,day,hour,minute,second, millisecond : (facultatif) Les autres composants de date et d'heure. Les composants omis utilisent par défaut leur valeur valide la plus basse.

  • isoWeekYear,isoWeek, isoDayOfWeek : (facultatif) composants de date ISO 8601. Utilisez-les au lieu de yearmonth, et day pour construire une date à partir d'une date de semaine ISO 8601.

  • timezone: (facultatif) Fuseau horaire à utiliser lors de la construction de la date. Si ce n'est pas spécifié, l'UTC est utilisé.

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$dateFromPartsopérateur pour créer une date à partir de composants individuels.

Création d'exemples de documents

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

Exemple de requête

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

Sortie

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

Exemples de code

Pour afficher un exemple de code d'utilisation de la $dateFromParts commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

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