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
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
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 | Antes do meio dia e após o meio dia. | `a` |
| AM ou PM | Antes do meio dia e após o meio dia. | `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, \$107:00.
+ Fusos horários compensados sem dois pontos. Por exemplo, \$10730.
### Formatos de data definidos previamente
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 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
Para incluir palavras em seus formatos de data, como a palavra “de” em *20 de setembro de 2021*, insira barras invertidas (\$1) 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
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.