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.

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

Der `$dateToString` Aggregationsoperator in Amazon DocumentDB wird verwendet, um einen Datums- oder Zeitstempelwert in eine Zeichenkettendarstellung zu konvertieren. Dies ist nützlich, wenn Sie Datum und Uhrzeit für die Anzeige oder Weiterverarbeitung auf eine bestimmte Weise formatieren müssen.

**Parameter**
+ `date`: Der Datums- oder Zeitstempelwert, der in eine Zeichenfolge konvertiert werden soll.
+ `format`: Eine Zeichenfolge, die das Format angibt, in dem das Datum dargestellt werden soll. Die Formatzeichenfolge kann verschiedene Formatbezeichner enthalten, z. B. `%Y` für das vierstellige Jahr, `%m` für den zweistelligen Monat, `%d` für den zweistelligen Tag des Monats usw.
+ `timezone`: (optional) Die Zeitzone, die für die Konvertierung verwendet werden soll. Falls nicht angegeben, wird die Zeitzone des Servers verwendet, der den Amazon DocumentDB-Cluster hostet.
+ `onNull`: (optional) Der Wert, der zurückgegeben werden soll, wenn der `date` Parameter. `null`

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

Das folgende Beispiel zeigt die Verwendung des `$dateToString` Operators zur Formatierung des `logDate` Felds der `missionLog` Sammlung.

**Erstellen Sie Beispieldokumente**

```
db.missionLog.insertMany([
  { _id: 1, "event":"missionStart", logDate: new Date("2020-03-15T13:41:33Z") },
  { _id: 2, "event":"jumpPoint1", logDate: new Date("2020-03-15T13:45:34Z") },
  { _id: 3, "event":"jumpPoint2", logDate: new Date("2020-03-15T13:48:21Z") },
  { _id: 4, "event":"jumpPoint3", logDate: new Date("2020-03-15T13:52:09Z") },
  { _id: 5, "event":"missionEnd", logDate: new Date("2020-03-15T13:58:44Z") }
]);
```

**Beispiel für eine Abfrage**

```
db.missionLog.aggregate([
  {
    $project: {
      event: "$event",
      logDateFormatted: {
        $dateToString: {
          format: "%Y-%m-%d %H:%M:%S",
          date: "$logDate"
        }
      }
    }
  }
])
```

**Ausgabe**

```
[
  {
    "_id": 1,
    "event": "missionStart",
    "logDateFormatted": "2020-03-15 13:41:33"
  },
  {
    "_id": 2,
    "event": "jumpPoint1",
    "logDateFormatted": "2020-03-15 13:45:34"
  },
  {
    "_id": 3,
    "event": "jumpPoint2",
    "logDateFormatted": "2020-03-15 13:48:21"
  },
  {
    "_id": 4,
    "event": "jumpPoint3",
    "logDateFormatted": "2020-03-15 13:52:09"
  },
  {
    "_id": 5,
    "event": "missionEnd",
    "logDateFormatted": "2020-03-15 13:58:44"
  }
]
```

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

Um ein Codebeispiel für die Verwendung des `$dateToString` Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

------
#### [ Node.js ]

Hier ist ein Beispiel für die Verwendung des `$dateToString` Operators in einer Node.js -Anwendung:

```
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('missionLog');

  const result = await collection.aggregate([
    {
      $project: {
        event: "$event",
        logDateFormatted: {
          $dateToString: {
            format: "%Y-%m-%d %H:%M:%S",
            date: "$logDate"
          }
        }
      }
    }
  ]).toArray();

  console.log(result);
  await client.close();
}

example();
```

------
#### [ Python ]

Hier ist ein Beispiel für die Verwendung des `$dateToString` Operators in einer Python-Anwendung:

```
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['missionLog']

    pipeline = [
        {
            '$project': {
                'event': '$event',
                'logDateFormatted': {
                    '$dateToString': {
                        'format': '%Y-%m-%d %H:%M:%S',
                        'date': '$logDate'
                    }
                }
            }
        }
    ]

    result = list(collection.aggregate(pipeline))
    print(result)
    client.close()

example()
```

------