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á.

# Personalizando formatos de data no Quick
<a name="format-visual-date-controls"></a>

No Quick, você pode personalizar a forma como as datas são formatadas em seus filtros e controles de parâmetros. Por exemplo, você pode especificar a formatação da data em um controle como 20/9/2021 ou, se preferir, como 9/20/2021. Você também pode especificar a redução dos nomes dos meses em suas datas (como setembro) para três letras (set.), entre outras personalizações.

Veja, a seguir, uma lista de tokens que você pode usar para criar formatos de data personalizados. É possível usá-los combinados para controlar como as datas aparecem em seus controles.

## Lista de tokens com suporte para a formatação de datas
<a name="format-date-supported-tokens"></a>

Use os seguintes tokens para personalizar o formato das datas no Quick.


| Exemplo | Description | Token | 
| --- | --- | --- | 
| 0–6 | Representação numérica de um determinado dia da semana. 0 corresponde a domingo e 6 corresponde a sábado. | `d` | 
| Se–Do | Uma representação textual com dois caracteres de um determinado dia da semana. | `dd` | 
| Seg–Dom | Uma representação textual com três caracteres de um determinado dia da semana. | `ddd` | 
| Segunda–Domingo | Uma representação textual de um determinado dia da semana. | `dddd` | 
| 99 ou 21 | Uma representação com dois dígitos de um ano. | `YY` | 
| 1999 ou 2021 | Uma representação numérica completa com quatro dígitos de um ano. | `YYYY` | 
| 1–12 | Número que representa um mês, sem zeros à esquerda. | `M` | 
| 1.º, 2.º até 12.º | Número que representa um mês, sem zeros à esquerda e com um sufixo ordinal. | `Mo` | 
| 01–12 | Número que representa um mês, com zeros à esquerda. | `MM` | 
| Jan–Dez | Uma representação textual com três dígitos de um mês. | `MMM` | 
| Janeiro–Dezembro | Uma representação textual completa de um mês. | `MMMM` | 
| 1–4 | Uma representação numérica de um trimestre. | `Q` | 
| 1.º–4.º | Uma representação numérica de um trimestre com um sufixo ordinal. | `Qo` | 
| 1–31 | Dia do mês, sem zeros à esquerda. | `D` | 
| 1.º, 2.º até 31.º | Dia do mês, sem zeros à esquerda e com um sufixo ordinal. | `Do` | 
| 01–31 | Um dia do mês com dois dígitos e com zeros à esquerda. | `DD` | 
| 1–365 | Dia do ano, sem zeros à esquerda. | `DDD` | 
| 001–365 | Dia do ano, com zeros à esquerda. | `DDDD` | 
| 1–53 | Semana do ano, sem zeros à esquerda. | `w` | 
| 1ª–53ª | Semana do ano, sem zeros à esquerda e com um sufixo ordinal. | `wo` | 
| 01–53 | Semana do ano, com zeros à esquerda. | `ww` | 
| 1–23 | Horas, no formato de 24 horas, sem zeros à esquerda. | `H` | 
| 01–23 | Horas, no formato de 24 horas, com zeros à esquerda. | `HH` | 
| 1–12 | Horas, no formato de 12 horas, sem zeros à esquerda. | `h` | 
| 01–12 | Horas, no formato de 12 horas, com zeros à esquerda. | `hh` | 
| 0–59 | Minutos, sem zeros à esquerda. | `m` | 
| 00–59 | Minutos, com zeros à esquerda. | `mm` | 
| 0–59 | Segundos, sem zeros à esquerda. | `s` | 
| 00–59 | Segundos, com zeros à esquerda. | `ss` | 
| am ou pm | am/pm | `a` | 
| AM ou PM | AM/PM | `A` | 
| 1632184215 | Carimbo de data/hora do Unix. | `X` | 
| 1632184215000 | Carimbo de data/hora do Unix em milissegundos. | `x` | 
| Z | Compensação UTC de zero. | `Z` | 

Os tipos de data apresentados a seguir não têm suporte.
+ Fusos horários compensados com dois pontos. Por exemplo, \+07:00.
+ Fusos horários compensados sem dois pontos. Por exemplo, \+0730.

### Formatos de data definidos previamente
<a name="visuals-preset-date-formats"></a>

Para personalizar rapidamente datas e horas para que apareçam como um dos formatos de exemplo a seguir, você pode usar os seguintes tokens predefinidos rápidos.


| Exemplo | Token | 
| --- | --- | 
| 20:30 | `LT` | 
| 20:30:25 | `LTS` | 
| 2 de agosto de 1985 | `LL` | 
| 2 de ago. de 1985 | `ll` | 
| 2 de agosto de 1985, 20:30 | `LLL` | 
| 2 de ago. de 1985, 20:30 | `lll` | 
| Quinta-feira, 2 de agosto de 1985, 20:30 | `LLLL` | 
| Qui, 2 de ago. de 1985, 20:30 | `llll` | 

## Formatos de data comuns
<a name="visuals-common-date-formats"></a>

A seguir são apresentados três exemplos de datas comuns e os formatos de tokens associados para referência rápida.


| Exemplo | Formato do token | 
| --- | --- | 
| 20 de setembro de 2021 | `MMM DD, YYYY` | 
| 20/9/21 17:00 | `DD-MM-YY ha` | 
| Segunda-feira, 20 de setembro de 2021, 17:30:15 | `dddd, MMMM DD, YYYY HH:mm:ss` | 

## Como adicionar palavras a datas
<a name="visuals-adding-words-to-dates"></a>

Para incluir palavras em seus formatos de data, como a palavra “de” em *20 de setembro de 2021*, insira barras invertidas (\\) antes de cada caractere da palavra. Por exemplo, para o exemplo de data 20 de setembro de 2021, use o seguinte formato de token: `Do \o\f MMM, YYYY`.

## Exemplo: como personalizar o formato de data em um controle de filtro
<a name="format-visual-date-controls-example"></a>

Use o procedimento apresentado a seguir para aprender a usar formatos de tokens de data para personalizar datas para um controle de filtro.

**Aprender a personalizar datas para um controle de filtro com tokens de dados**

1. Em uma análise rápida, escolha o controle de filtro que você deseja personalizar.

1. No controle de filtro, escolha o ícone **Editar controle**.

1. Na página **Editar controle** que é aberta, em **Formato de data**, insira o formato de data personalizado desejado. Use os tokens listados anteriormente neste tópico.

   Por exemplo, digamos que você deseje personalizar as datas usando o seguinte formato: *3 de setembro de 2020 às 17h*. Para fazer isso, você pode inserir o seguinte formato de token:

   `MMM Do, YYYY \a\t ha`

   Uma pré-visualização do formato de data aparece abaixo do campo de entrada conforme você insere cada token.

1. Escolha **Aplicar**.

   As datas no controle serão atualizadas para o formato especificado.