--- schema_version: "1" id: 92e316d189bdfdc730816869112e92cb8749dc412cb41b2c464c16fe62579756 title: Formatos de data personalizados collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/server-linux/dates_custom_date_formats.md canonical_url: https://help.tableau.com/current/server-linux/pt-br/dates_custom_date_formats.htm source_site: help.tableau.com content_type: documentation content_hash: 9b8cfde315c975250aee82529e2b57c503376d84d5ca02778860878f368c8cc1 description: Format date fields in a view using custom date format symbols, including Japanese era formats. --- [Pular para o conteúdo principal](#main-content) # Formatos de data personalizados Este artigo discute o uso do campo de formato de data personalizado para formatar as datas em uma exibição. Para obter uma visão geral de como o Tableau trabalha com datas, consulte [Datas e horários](https://help.tableau.com/current/pro/desktop/pt-br/dates.htm) ou [Alteração de níveis de data](https://help.tableau.com/current/pro/desktop/pt-br/dates_levels.htm) . Para definir as propriedades de data para uma **fonte de dados**, consulte [Propriedades de data para uma fonte de dados](https://help.tableau.com/current/pro/desktop/pt-br/date_properties.htm). ## Como encontrar o campo de formato de data personalizado ### Formatar um campo de data em uma exibição (Tableau Desktop) Para formatar um campo de data na exibição no Tableau Desktop, clique com o botão direito do mouse (clique pressionando Control, no Mac) no campo e escolha Formatar. ![Menu de contexto de uma exibição que mostra a opção de formato destacada.](/tableau/current/pt-br/server-linux/pt-br/Img/date_format_view.png) Isso abrirá o painel Formatar à esquerda da exibição. Selecione o campo Datas. ![Painel de cabeçalho com o menu suspenso de formatação de data destacado.](/tableau/current/pt-br/server-linux/pt-br/Img/date_format_pane.png) O Tableau apresenta uma lista de formatos disponíveis. Se você estiver trabalhando com uma parte de data discreta, verá as opções relevantes para essa parte de data (como automática, dois dígitos e quatro dígitos como as opções para **YEAR(\[Order Date\])**). Para datas contínuas ou discretas de Data exata, o último item na lista é Personalizar. Você pode especificar uma data personalizada usando os símbolos de formatação listados na tabela Símbolos de formatos de data compatíveis, sozinhos ou combinados. ### Formatar um campo de data em uma exibição (Tableau Cloud e Tableau Server) Para formatar um campo de data na exibição no Tableau Cloud e Tableau Server, clique com o botão direito do mouse (clique pressionando Control, no Mac) no campo e escolha Formatar data. ![](/tableau/current/pt-br/server-linux/pt-br/Img/CustomDate_Cloud.png) ### Formatar um campo de data no painel Dados (somente Tableau Desktop) Para formatar um campo de data no painel Dados, clique com o botão direito no campo e escolha Propriedades padrão > Formato de dados. ![Janela de formato de data padrão com várias opções de formato de data e a opção personalizada selecionada.](/tableau/current/pt-br/server-linux/pt-br/Img/date_format_custom.png) Os formatos de data listados na tabela são compatíveis quando a sua pasta de trabalho está conectada a uma extração do Tableau ou tem uma conexão em tempo real com a fonte de dados que também é compatível com o formato de data. (Consulte a documentação de sua fonte de dados para verificar se o formato de data desejado é compatível). O Tableau recupera o formato de data na fonte de dados. O Tableau Server também pode recuperar formatos de data da conta de usuário Run As no servidor que executa o Tableau Server. **Observação:** os formatos de data a seguir podem não ser os mesmos que os utilizados com a função [Conversão de tipo](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_typeconversion.htm). Consulte [Converter cadeias de caracteres em campos de data](https://help.tableau.com/current/pro/desktop/pt-br/data_dateparse.htm) para obter mais informações sobre como usar a função DATEPARSE. ## Símbolos de formatos de data compatíveis Use os símbolos a seguir para criar um formato de data personalizado.
SímboloDescrição
(:)Separador de hora. Em alguns locais, um caractere diferente é usado para representar o separador de hora. O separador de hora separa horas, minutos e segundos quando os valores da hora são formatados. Na prática, o caractere que é usado como separador de hora na saída formatada é determinado pelas configurações do sistema.
(/)Separador de data. Em alguns locais, um caractere diferente é usado para representar o separador de data. O separador de data separa o dia, mês e ano quando os valores da data são formatados. Na prática, o caractere que é usado como separador de data na saída formatada é determinado pelas configurações do sistema.
cExibe a data como ddddd e a hora como
ttttt, nesta ordem. Exibe somente as informações de data, se não houver parte fracional no número de série da data; exibe somente as informações de tempo, se não houver parte inteira.
dExibe o dia como um número sem um zero à esquerda (1-31).
ddExibe o dia como um número com um zero à esquerda (01-31).
dddExibe o dia como uma abreviação (dom, sáb).
ddddExibe o dia como um nome completo (domingo, sábado).
dddddExibe a data como uma data completa (incluindo dia, mês e ano), formatada de acordo com a configuração de formato de data curta do seu sistema. O formato de data curta padrão é m/d/yy.
ddddddExibe um número de série de data como uma data completa (incluindo dia, mês e ano) formatada de acordo com a configuração de data longa reconhecida pelo seu sistema. O formato de data longa padrão é mmmm dd, yyyy.
aaaaO mesmo que dddd, mas é a versão localizada da cadeia de caracteres.
wExibe o dia da semana como um número (1 para domingo e 7 para sábado).
wwExibe a semana do ano como um número (1-54).
MExibe o mês como um número sem um zero à esquerda (1 12). Se m vier logo após de h ou hh, o minuto é exibido, em vez do mês.
MMExibe o mês como um número com um zero à esquerda (01-12). Se m vier logo após de h ou hh, o minuto é exibido, em vez do mês.
MMMExibe o mês como uma abreviação (jan-dez).
MMMMExibe o mês como nome do mês completo (janeiro-dezembro).
MMMMMExibe o mês como uma abreviatura de uma única letra (J-D)
ooooO mesmo que MMMM, mas localizado.
qExibe o trimestre como um número (1-4).
yExibe o dia do ano como um número (1-366).
yyExibe o ano como um número de 2 dígitos (00-99).
yyyyExibe o ano como um número de 4 dígitos (100-9999).
hExibe a hora como um número sem os zeros à esquerda (0-23).
HhExibe a hora como um número com zeros à esquerda (00-23).
NExibe o minuto como um número sem zeros à esquerda (0 59).
NnExibe o minuto como um número com zeros à esquerda (00 59).
SExibe o segundo como um número sem os zeros à esquerda (0 59).
SsExibe o segundo como um número com zeros à esquerda (00 59).
000Exibe os milissegundos. Usa um caractere de ponto final como separador, antes de especificar os milissegundos.
t t t t tExibe uma hora como hora completa (incluindo hora, minuto e segundo), formatada usando o separador de hora definido pelo formato de hora reconhecido pelo seu sistema. Um zero à esquerda será exibido se a opção de zero à esquerda for selecionada e a hora estiver antes de 10:00 ou 22:00. O formato de hora padrão é h:mm:ss.
AM/PMUsa o relógio de 12 horas e exibe AM em letra maiúscula com qualquer hora antes do meio-dia; exibe um PM em letra maiúscula com qualquer hora entre meio-dia e 11:59 P.M.
am/pmUsa o relógio de 12 horas e exibe AM em letra minúscula com qualquer hora antes do meio-dia; exibe um PM em letra minúscula com qualquer hora entre meio-dia e 11:59 P.M.
A/PUsa o relógio de 12 horas e exibe A em letra maiúscula com qualquer hora antes do meio-dia; exibe um P em letra maiúscula com qualquer hora entre meio-dia e 11:59 P.M.
a/pUsa o relógio de 12 horas e exibe A em letra minúscula com qualquer hora antes do meio-dia; exibe um P em letra minúscula com qualquer hora entre meio-dia e 11:59 P.M.
AMPMUsa o relógio de 12 horas e exibe a cadeia de caracteres literal AM conforme definida pelo seu sistema com qualquer hora antes do meio-dia; exibe a cadeia de caracteres literal PM conforme definida pelo seu sistema com qualquer hora entre meio-dia e 11:59 P.M. AM/PM pode ser em minúscula e maiúscula, mas letra da cadeia caracteres exibida corresponde à cadeia de caracteres definida pelas configurações do seu sistema. O formato padrão é AM/PM.
## Exemplos de formatos de data personalizados É possível usar qualquer um dos símbolos do formato de data na tabela acima sozinho ou combinado com outro. Especificar um formato personalizado yyyy-MM-dd HH:mm:ss.000 criaria datas no formato 2015-05-10 11:22:16.543. Esse formato pode ser adequado para dados científicos. Especificar um formato personalizado DDDD DD criaria datas que mostram o Dia da semana e o Dia, como mostrado abaixo. ![](/tableau/current/pt-br/server-linux/pt-br/Img/FormattingNumbersDates_CustomDateFinal.png) Especificar um formato personalizado `yy-mm-dd (dddd)` criaria datas no formato **18-01-04 (quinta-feira)**. Especificar um formato personalizado t `"Q"1 YYYY` criaria datas que mostram **Q1 2018**. ## Suporte para formatos de data japoneses baseados em era O Tableau aceita os formatos de data japoneses baseados em era imperial (Wareki). Veja como aplicar um formato de data baseado em era a um campo na sua exibição: 1. Defina a localidade da pasta de trabalho como Japonês. 2. Clique com o botão direito do mouse no campo na exibição para o qual deseja definir o formato de data. 3. Escolha Formatar. 4. No painel Formatar, na lista suspensa Datas, selecione um formato. Se o formato que você deseja não estiver listado, será possível criar seu próprio formato de data. Para fazer isso, escolha Formatação personalizada na caixa Datas, em seguida, digite seu formato usando os placeholders de data do Tableau. Os placeholders de ano baseados em era a seguir estão disponíveis:
SímboloDescrição
gNome de era curto (como H para a era Heisei).
ggNome da era (como 平成).
gggNome de era longo (para o japonês, isso é o mesmo que o nome de era regular).
eAno baseado em era, como 1 para o primeiro ano de uma era.
eeAno baseado em era, como 01 para o primeiro ano de uma era. Se houver somente um dígito, o ano baseado em era terá um zero adicionado na frente.
Se a localidade da pasta de trabalho não é japonês, será possível criar um formato de data personalizado e, em seguida, inserir o código de idioma !ja\_JP! na frente do seu formato, de modo que seja semelhante a: `!ja_JP! gg ee"年"mm"月"dd"日"` O código de idioma força a data a ser tratada como se fosse uma data japonesa. As datas baseadas em era que não forem completamente aceitas pela exibição do navegador do Tableau Server. Particularmente, se você publicar uma pasta de trabalho que contenha filtro interativo, os placeholders e ou g atualizada, não serão preenchidos: ![ ](/tableau/current/pt-br/server-linux/pt-br/Img/japaneseEra.png) Para evitar este problema, não mostre datas baseadas em era nos filtros interativos se a sua pasta de trabalho for visualizada em um navegador. ## Utilização de um texto literal em um formato de data Você pode desejar que o seu formato de data inclua algumas palavras ou frases, como **Trimestre fiscal q de yyyy**. Entretanto, se você digitar este texto diretamente na caixa de formato do Tableau, ele pode tratar as letras como partes de datas: ![ ](/tableau/current/pt-br/server-linux/pt-br/Img/dateFormatEscape.png) Para evitar que o Tableau faça isso, coloque entre aspas duplas as letras e palavras que não deveriam ser tratadas como parte de datas: `"Fiscal Quarter" q "of" yyyy`. Se desejar uma citação literal dentro de uma seção citada, insira este código: `"\""`. Por exemplo, o formato `"Fiscal "\"" Quarter"` seria formatado como **Fiscal " Quarter**. ## Sintaxe de formato na função DATEPARSE para fontes de dados de extração Se estiver usando a função DATEPARSE em uma extração, use a sintaxe definida pelo Unicode Consortium. Esta tabela lista os formatos aceitos pela função DATEPARSE.
Parte da dataSímboloSaída de exemplo
Ano

yy

y, yyyy

Y

26

2026

2026 (usado para calendários baseados na Semana do ano)

Trimestre do ano

Q

QQ

QQQ

QQQQ

2

02

Q2

Segundo trimestre

Mês

M

MM

MMM

MMMM

9

09

Set

Setembro

Semana do anow, ww47
Dia da semana

E, EE, EEE

EEEE

EEEEE

Seg

Segunda-feira

M

Dia do mês

d

dd

1, 15

01, 15

Dia do ano (1-365)D23, 143

Hora (1-12)

h

hh

8

08

Hora (0-23)

H

HH

8

08

Minuto

m

mm

8

08

Segundo em um minuto

s

ss

5

05

Segundo fracionado

S

SS

SSS

SSSS

2

23

235

2350

Milissegundos durante o diaA34532
Período (marcador am/pm)a, aa, aaaAM, am, PM
Fuso horário

z, zz, zzz

zzzz

Z, ZZ, ZZZ

ZZZZ

PDT

Horário de Verão do Pacífico

-0800

PST-08:00

Para obter uma lista completa de símbolos de data, consulte [Visão geral da formatação de data e nos Componentes internacionais](https://unicode-org.github.io/icu/userguide/format_parse/datetime/) de uma página Unicode. **Observação:** Alguns formatos de data não são compatíveis com todos os tipos de bancos de dados e arquivos. ### Observações sobre formatos de data em extrações .hyper
Unidade de tempoObservações
Eran/a
Ano

Todos os símbolos são aceitos em extrações .hyper, exceto “U”.

Observações:

  • valores negativos representam um ano antes de Cristo (AC). Por exemplo, DATEPARSE('y','-10') retorna o primeiro mês de janeiro de 11BC e DATEPARSE('y','-0') retorna o primeiro mês de janeiro de 1BC.

  • Ao trabalhar com o ano do calendário “y”, o padrão “yy” solicita dois dígitos de baixa ordem do ano. Para os números < 70, a função DATEPARSE retorna o ano 2000+x. Para os números >=70, a função DATEPARSE retorna o ano 1900+x.

  • Ao trabalhar com “Y” em calendários baseados em “data de semana ISO”, a transição de ano ocorre em um limite de semana e pode ser diferente da transição de ano de calendário. A designação "Y" é usada em conjunto com o caractere padrão "w" no calendário de ano-semana ISO. O sistema de data de semana ISO é efetivamente um sistema de calendário de semanas bissextas, parte da norma de data e hora de ISO 8601. Igual ao “y”, os valores negativos de “Y” representam um ano antes de Cristo (AC).

Mês

Todos os símbolos são aceitos em extrações .hyper, exceto “I”.

Observações: 

  • as designações de mês são usadas juntamente com “d” para o número do dia.

  • Em contraste com ICU, as extrações .hyper permitem valores de 1 a 12. Outros valores causam um erro.

Semana

Todos os símbolos são aceitos em extrações .hyper, exceto “W”.

Observações:

  • ao trabalhar com "w", em contraste com ICU, as extrações .hyper permitem somente semanas válidas. Um ano tem 52 ou 53 semanas (ISO 8601). A função DATEPARSE valida a entrada. Por exemplo, um erro ocorre na 53ª semana de 2016, porque a 53ª semana não existe em 2016.

  • Ao trabalhar com “W”, ICU não aceita essa designação, mas é útil para datas como a primeira segunda-feira de setembro.

Dia

Observações:

  • ao trabalhar com "d", em contraste com ICU, as extrações .hyper permitem somente números de dias válidos. Por exemplo, um erro ocorre para o 31º dia de fevereiro.

  • ao trabalhar com "d", em contraste com ICU, as extrações .hyper permitem somente números de dias válidos. Por exemplo, um erro ocorre para o 366º dia de 2017.

Hora

Apenas os símbolos "h" e "H" são compatíveis em exportações .hyper.

Observações:

  • ao trabalhar com "h", a extração .hyper não permite valores negativos para este campo. Valores negativos causam um erro.

  • ao trabalhar com "h", as extrações .hyper não permitem valores negativos para este campo. Valores negativos causam um erro.

MinutoObservação: em contraste com ICU, as extrações .hyper não permitirão valores negativos para este campo. Valores negativos causarão um erro.
Segundo

Observações: 

  • em contraste com ICU, as extrações .hyper não permitirão valores negativos para este campo. Valores negativos causarão um erro.

  • Ao trabalhar com "S," DATEPARSE('ss.SSSS', '12.3456') retorna 1990-01-01 00:00:12:3456 AD.
TrimestreObservação: em contraste com ICU, as extrações .hyper somente permitem valores de 1 a 4. Todos os outros valores causam um erro.
Dia da semana

Observações: 

  • ao trabalhar com “e” mais “ee”, em contraste com ICU, as extrações .hyper permitem somente valores de 1 a 7. Todos os outros valores causam um erro.

  • Ao trabalhar com “c..cc”, em contraste com ICU, as extrações .hyper permitem somente valores de 1 a 7. Todos os outros valores causam um erro.

Períodon/a