$year - 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.

$year

L'$yearopérateur d'Amazon DocumentDB extrait le composant annuel d'une date ou d'un horodatage.

Paramètres

  • expression: expression de date ou d'horodatage à partir de laquelle extraire le composant annuel.

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$yearopérateur pour extraire le composant annuel d'un champ de date.

Création d'exemples de documents

db.events.insertMany([
  { "_id": 1, "date": ISODate("2023-04-15T00:00:00Z") },
  { "_id": 3, "date": ISODate("2021-12-31T00:00:00Z") }
]);

Exemple de requête

db.events.aggregate([
  { $project: { year: { $year: "$date" } } }
]);

Sortie

[
  { "_id": 1, "year": 2023 },
  { "_id": 3, "year": 2021 }
]

Exemples de code

Pour afficher un exemple de code d'utilisation de la $year 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('events');

  const result = await collection.aggregate([
    { $project: { year: { $year: "$date" } } }
  ]).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': {'year': {'$year': '$date'}}}
    ]))

    print(result)

    client.close()

example()