Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

`formatDate` da formato a una fecha utilizando el patrón que especifique. Cuando esté preparando datos, puede utilizar `formatDate` para cambiar el formato de la fecha. Para volver a dar formato a una fecha en un análisis, elija la opción de formato en el menú contextual del campo de fecha.

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

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

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

 *date*   
Un campo de fecha o una llamada a otra función que genera una fecha.

 *format*   
(Opcional) Una cadena que contiene el patrón de formato que se va a aplicar. Este argumento acepta los patrones de formato especificados en los [formatos de fecha admitidos](https://docs.aws.amazon.com/quicksight/latest/user/supported-date-formats.html).  
Si no especifica un formato, el valor predeterminado de esta cadena es yyyy-MM-dd**T**kk: mm: ss: SSS.

## Tipo de devolución
<a name="formatDate-function-return-type"></a>

Cadena

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

En el ejemplo siguiente se da formato a una fecha UTC.

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

Los siguientes son los valores de los campos.

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

Para estos valores de campo, se devuelven los siguientes valores.

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

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

Si la fecha contiene comillas simples o apóstrofes, por ejemplo, `yyyyMMdd'T'HHmmss`, puede gestionar este formato de fecha mediante uno de los métodos siguientes.
+ Escriba la fecha completa entre comillas, tal como se muestra en el siguiente ejemplo:

  ```
  formatDate({myDateField}, "yyyyMMdd'T'HHmmss")
  ```
+ Para evitar las comillas simples o los apóstrofes, añada una barra invertida (`\`) a su izquierda, como se muestra en el siguiente ejemplo: 

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