As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

`formatDate` formata uma data usando um padrão que você especificar. Ao preparar dados, você pode usar `formatDate` para reformatar a data. Para reformatar uma data em uma análise, escolha a opção de formato no menu de contexto no campo de data.

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

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

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

 *data*   
Um campo de data ou uma chamada para outra função que gera uma data.

 *format*   
(Opcional) Uma string contendo o padrão de formato a ser aplicado. Esse argumento aceita os padrões de formato especificados em Formatos de [data suportados](https://docs.aws.amazon.com/quicksight/latest/user/supported-date-formats.html).  
Se você não especificar um formato, a sequência de caracteres usa o padrão aaaa-MM-dd**T**kk:mm:ss:SSS.

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

String

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

O exemplo a seguir formata uma data UTC.

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

A seguir estão os valores de campo especificados.

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

Para esses valores de campo, os seguintes valores são retornados.

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

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

Se a data contiver aspas simples ou apóstrofos, por exemplo `yyyyMMdd'T'HHmmss`, você poderá manipular esse formato de data usando um dos métodos a seguir.
+ Coloque a data inteira entre aspas duplas, como mostrado no seguinte exemplo:

  ```
  formatDate({myDateField}, "yyyyMMdd'T'HHmmss")
  ```
+ Evite as aspas simples ou apóstrofos adicionando uma barra invertida ( `\` ) à esquerda, conforme mostrado no seguinte exemplo: 

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