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.

# formatDate
<a name="formatDate-function"></a>

`formatDate` formatiert ein Datum in dem von Ihnen angegebenem Muster. Wenn Sie Daten vorbereiten, können Sie mit `formatDate` das Datum neu formatieren. Um ein Datum in einer Analyse neu zu formatieren, wählen Sie die Formatoption im Kontextmenü des Datumsfelds aus.

## Syntax
<a name="formatDate-function-syntax"></a>

```
formatDate(date, ['format'])
```

## Argumente
<a name="formatDate-function-arguments"></a>

 *date*   
Ein Datumsfeld oder der Aufruf einer anderen Funktion, die ein Datum ausgibt.

 *format*   
(Optional) Eine Zeichenfolge, die das anzuwendende Muster enthält. Dieses Argument akzeptiert die [unter Unterstützte Datumsformate](https://docs.aws.amazon.com/quicksight/latest/user/supported-date-formats.html) angegebenen Formatmuster.  
Wenn Sie kein Format angeben, ist diese Zeichenfolge standardmäßig yyyy-MM-dd**T**kk: mm: ss: SSS.

## Rückgabetyp
<a name="formatDate-function-return-type"></a>

Zeichenfolge

## Beispiel
<a name="formatDate-function-example"></a>

Im folgenden Beispiel wird ein UTC-Datum formatiert.

```
formatDate(orderDate, 'dd-MMM-yyyy')
```

Das Feld enthält folgende Werte.

```
order date      
=========
2012-12-14T00:00:00.000Z  
2013-12-29T00:00:00.000Z
2012-11-15T00:00:00.000Z
```

Für diese Feldwerte werden die folgenden Ergebniswerte zurückgegeben.

```
13 Dec 2012
28 Dec 2013
14 Nov 2012
```

## Beispiel
<a name="formatDate-function-example2"></a>

Wenn das Datum beispielsweise einfache Anführungszeichen oder Apostrophe wie z. B. `yyyyMMdd'T'HHmmss` enthält, können Sie dieses Datumsformat mit einer der folgenden Methoden verarbeiten.
+ Schließen Sie das gesamte Datum in doppelte Anführungszeichen ein, wie im folgenden Beispiel gezeigt:

  ```
  formatDate({myDateField}, "yyyyMMdd'T'HHmmss")
  ```
+ Vermeiden Sie einfache Anführungszeichen oder Apostrophe, indem Sie, wie im folgenden Beispiel dargelegt, links neben ihnen einen umgekehrten Schrägstrich (`\`) hinzufügen: 

  ```
  formatDate({myDateField}, 'yyyyMMdd\'T\'HHmmss')
  ```