Esta página contém a lista completa de padrões de modelo e modificadores de padrão de modelo que podem ser usados ao formatar data e hora no PostgreSQL.
Padrões de modelo
A tabela a seguir lista todos os padrões de modelo que podem ser usados em suas strings de formato ao formatar data e hora no Postgres.
Padrão | Descrição |
---|---|
HH | Hora do dia (01-12). |
HH12 | Hora do dia (01-12). |
HH24 | Hora do dia (00-23). |
MI | Minuto (00-59). |
SS | Segundo (00-59). |
MS | Milisegundo (000-999). |
US | Microssegundo (000000-999999). |
SSSS | Segundos depois da meia-noite (0-86399). |
A.M. , am , P.M. ou pm | Indicador de Meridiem (sem pontos). |
A.M. , a.m. , P.M. ou p.m. | Indicador de Meridiem (com pontos). |
Y,YYY | Ano (4 ou mais dígitos) com vírgula. |
YYYY | Ano (4 ou mais dígitos). |
YYYY | Últimos 3 dígitos do ano. |
YY | Últimos 2 dígitos do ano. |
Y | Último dígito do ano. |
IYYY | ano de numeração de semana ISO 8601 (4 ou mais dígitos). |
IYYY | Últimos 3 dígitos do ano de numeração de semana ISO 8601. |
IY | Últimos 2 dígitos do ano de numeração de semana ISO 8601. |
I | Último dígito do ano de numeração de semana ISO 8601. |
B.C. , bc , AD ou ad | Indicador de era (sem pontos). |
B.C. , b.c. , A.D. ou a.d. | Indicador de era (com pontos). |
MONTH | Nome do mês em letras maiúsculas (preenchido em branco até 9 caracteres). |
Month | Nome do mês em letras maiúsculas (preenchido em branco até 9 caracteres). |
month | Nome completo do mês em minúsculas (preenchido em branco até 9 caracteres). |
MON | Nome abreviado do mês em maiúsculas (3 caracteres em inglês, comprimentos localizados variam). |
Mon | Nome do mês em maiúsculas abreviado (3 caracteres em inglês, comprimentos localizados variam). |
mon | Nome abreviado do mês em minúsculas (3 caracteres em inglês, comprimentos localizados variam). |
MM | Número do mês (01-12). |
DAY | Nome do dia em letras maiúsculas (preenchido em branco até 9 caracteres). |
Day | Nome do dia em letras maiúsculas (preenchido em branco até 9 caracteres). |
day | Nome completo do dia em minúsculas (preenchido em branco até 9 caracteres). |
DY | Nome do dia em maiúsculas abreviado (3 caracteres em inglês, comprimentos localizados variam). |
Dy | Nome do dia em maiúsculas abreviado (3 caracteres em inglês, comprimentos localizados variam). |
dy | Nome do dia em minúsculas abreviado (3 caracteres em inglês, comprimentos localizados variam). |
DDD | Dia do ano (001-366). |
IDDD | Dia do ano de numeração da semana ISO 8601 (001-371; dia 1 do ano é segunda-feira da primeira semana ISO). |
DD | Dia do mês (01-31). |
Dy | Dia da semana, domingo (1 ) a sábado (7 ). |
ID | ISO 8601 dia da semana, segunda-feira (1 ) a domingo (7 ). |
W | Semana do mês (1-5) (a primeira semana começa no primeiro dia do mês). |
WW | Número da semana do ano (1-53) (a primeira semana começa no primeiro dia do ano). |
IW | Número da semana do ano de numeração de semanas ISO 8601 (01-53; a primeira quinta-feira do ano é na semana 1). |
CC | Século (2 dígitos) (o século XXI começa em 01-01-2001). |
J | Dia Juliano (dias inteiros desde 24 de novembro de 4714 aC à meia-noite UTC). |
Q | Trimestre. |
RM | Mês em algarismos romanos maiúsculos (I-XII; I=janeiro). |
rm | Mês em algarismos romanos minúsculos (i-xii; i=janeiro). |
TZ | Abreviação de fuso horário em maiúsculas (compatível apenas em to_char ). |
tz | Abreviação de fuso horário em letras minúsculas (compatível apenas em to_char ). |
TZH | Horas do fuso horário. |
TZM | Minutos de fuso horário. |
OF | Deslocamento de fuso horário do UTC (compatível apenas em to_char ). |
Modificadores de padrão de modelo
Os seguintes modificadores podem ser aplicados aos padrões de modelo acima para alterar o resultado.
Modificador | Descrição |
---|---|
FM prefixo | Modo de preenchimento (suprimir zeros à esquerda e espaços em branco de preenchimento). |
TH sufixo | Sufixo de número ordinal maiúsculo. |
th sufixo | Sufixo de número ordinal em minúsculas. |
FX prefixo | Opção global de formato fixo. |
TM prefixo | Modo de tradução (imprime nomes de dias e meses localizados com base em lc_time ). |
SP sufixo | Modo de feitiço (não implementado). |
Observe que alguns deles são adicionados como um prefixo ao padrão de modelo e outros são adicionados como um sufixo.
Todos os padrões e modificadores de modelo acima são baseados na documentação do Postgres, que inclui notas de uso. Para ver as notas de uso, clique nesse link e role para baixo. As notas de uso estão sob os modificadores de modelo.
Exemplo
Aqui está um exemplo rápido para demonstrar como funciona.
SELECT to_char(date '2020-12-01', 'Dth');
Resultado:
3rd
Neste caso, o
Dy
foi para o dia do mês (3 ), e o th
foi usado para adicionar o indicador ordinal (neste caso, rd ).