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 specificate un formato, il valore predefinito di questa stringa è yyyy- T kk:mm:ss:sss. MM-dd**

## 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{{'}})
  ```