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.

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

Der `$isoWeekYear` Operator in Amazon DocumentDB gibt die ISO-8601-Wochenjahreszahl für ein bestimmtes Datum zurück. Die ISO-Wochenjahreszahl unterscheidet sich vom gregorianischen Kalenderjahr dadurch, dass sich das Wochenjahr vom Kalenderjahr unterscheiden kann, insbesondere zu Beginn und Ende des Jahres.

**Parameter**
+ `expression`: Der Datumsausdruck, für den die Jahreszahl der ISO-8601-Woche zurückgegeben werden soll.

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

Dieses Beispiel zeigt, wie der `$isoWeekYear` Operator verwendet wird, um das ISO 8601-Wochenjahr für das Datumsfeld jedes Dokuments in der Eventsammlung abzurufen.

**Erstellen Sie Beispieldokumente**

```
db.events.insertMany([
  { _id: 1, name: "Event 1", date: ISODate("2022-12-31T00:00:00Z") },
  { _id: 2, name: "Event 2", date: ISODate("2023-01-01T00:00:00Z") },
  { _id: 3, name: "Event 3", date: ISODate("2023-01-02T00:00:00Z") }
]);
```

**Beispiel für eine Abfrage**

```
db.events.aggregate([
  { $project: {
    name: 1,
    isoWeekYear: { $isoWeekYear: "$date" }
  }}
]);
```

**Ausgabe**

```
[
  { "_id" : 1, "name" : "Event 1", "isoWeekYear" : 2023 },
  { "_id" : 2, "name" : "Event 2", "isoWeekYear" : 2023 },
  { "_id" : 3, "name" : "Event 3", "isoWeekYear" : 2023 }
]
```

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

Um ein Codebeispiel für die Verwendung des `$isoWeekYear` 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 events = db.collection('events');

  const result = await events.aggregate([
    { $project: {
      name: 1,
      isoWeekYear: { $isoWeekYear: '$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
    events = db.events

    result = list(events.aggregate([
        { '$project': {
            'name': 1,
            'isoWeekYear': { '$isoWeekYear': '$date' }
        }}
    ]))

    print(result)
    client.close()

example()
```

------