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.

# \$1isoWeek
<a name="isoWeek"></a>

L'`$isoWeek`opérateur dans Amazon DocumentDB renvoie le numéro de semaine ISO pour une date. Le système de date hebdomadaire ISO est un moyen de numéroter les semaines d'une année, la première semaine d'une nouvelle année étant la semaine qui contient le premier jeudi de cette année. Ceci est différent du calendrier grégorien, où la première semaine d'une nouvelle année est la semaine qui contient le 1er janvier.

**Paramètres**

Aucune

## Exemple (MongoDB Shell)
<a name="isoWeek-examples"></a>

L'exemple suivant montre comment utiliser l'`$isoWeek`opérateur pour récupérer le numéro de semaine ISO pour une date donnée.

**Création d'exemples de documents**

```
db.dates.insertMany([
  { _id: 1, date: new ISODate("2022-01-01") },
  { _id: 2, date: new ISODate("2022-12-31") },
  { _id: 3, date: new ISODate("2023-01-01") }
])
```

**Exemple de requête**

```
db.dates.aggregate([
  {
    $project: {
      _id: 1,
      isoWeek: { $isoWeek: "$date" }
    }
  }
])
```

**Sortie**

```
[
  { "_id": 1, "isoWeek": 52 },
  { "_id": 2, "isoWeek": 52 },
  { "_id": 3, "isoWeek": 1 }
]
```

## Exemples de code
<a name="isoWeek-code"></a>

Pour afficher un exemple de code relatif à l'utilisation de la `$isoWeek` 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('dates');

  const result = await collection.aggregate([
    {
      $project: {
        _id: 1,
        isoWeek: { $isoWeek: "$date" }
      }
    }
  ]).toArray();

  console.log(result);
  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['dates']

    result = list(collection.aggregate([
        {
            '$project': {
                '_id': 1,
                'isoWeek': { '$isoWeek': '$date' }
            }
        }
    ]))

    print(result)
    client.close()

example()
```

------