Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

`formatDate` formatta una data utilizzando un modello specificato. Quando si preparano i dati, è possibile utilizzare `formatDate` per riformattare la data. Per riformattare una data in un'analisi, scegli l'opzione di formato dal menu contestuale del campo data.

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

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

## Arguments (Argomenti)
<a name="formatDate-function-arguments"></a>

 *data*   
Un campo data o una chiamata a un'altra funzione che genera una data.

 *format*   
(Facoltativo) Stringa contenente il modello del formato da applicare. Questo argomento accetta i modelli di formato specificati in [Formati di data supportati](https://docs.aws.amazon.com/quicksight/latest/user/supported-date-formats.html).  
Se non si specifica un formato, per impostazione predefinita questa stringa viene impostata su yyyy-MM-dd**T**kk:mm:ss:SSS.

## Tipo restituito
<a name="formatDate-function-return-type"></a>

Stringa

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

L'esempio seguente formatta una data UTC.

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

I seguenti sono i valori di campo forniti.

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

Per questi valori di campo vengono restituiti i seguenti valori.

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

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

Se la data contiene virgolette singole o apostrofi, ad esempio `yyyyMMdd'T'HHmmss`, puoi gestire questo formato di data utilizzando uno dei seguenti metodi.
+ Racchiudi l'intera data tra virgolette doppie, come illustrato nell'esempio seguente:

  ```
  formatDate({myDateField}, "yyyyMMdd'T'HHmmss")
  ```
+ Evita le virgolette o gli apostrofi aggiungendo una barra rovesciata (`\`) alla loro sinistra, come illustrato nell'esempio seguente: 

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