Menu

Funções de data no PostgreSQL: now, interval, date_trunc

Trabalhe com datas no PostgreSQL: now() e current_date, somar e subtrair intervalos, date_trunc para agrupar, extract e age, e formatação com to_char.

Esta página tem editores executáveis. Edite, execute e veja a saída na hora.

now() retorna a data e a hora atuais e current_date retorna a data de hoje. Desloque qualquer um dos dois com um intervalo: now() - interval '30 days'. date_trunc('month', ts) arredonda um timestamp para baixo até o início do mês, extract(year FROM ts) tira um único campo e to_char(ts, 'YYYY-MM-DD') formata como texto.

Os pedidos 1 e 2 estão dentro dos últimos 30 dias. As datas exibidas dependem de quando você clica em Executar, porque as linhas são inseridas em relação a now().

Obter a data e a hora atuais

FunçãoRetornaTipo
now(), current_timestampData e hora em que a transação começoutimestamptz
current_dateA data de hojedate
localtimestampData e hora sem fuso horáriotimestamp
clock_timestamp()O horário real no momento da chamadatimestamptz

now() fica fixo durante toda a transação, então todas as linhas inseridas numa mesma transação recebem o mesmo timestamp. Use clock_timestamp() para medir etapas dentro de uma transação longa. Os resultados dependem da configuração TimeZone da sessão (veja timestamp vs timestamptz).

Somar e subtrair datas

Isso retorna 2026-12-17, 38, 2026-02-28 00:00:00 e 2 days 08:30:00. As regras:

  • date + integer e date - integer andam em dias e retornam um date.
  • date - date retorna o número de dias como inteiro.
  • date + interval retorna um timestamp; converta de volta com ::date se quiser uma data.
  • timestamp - timestamp retorna um interval.
  • Somar um mês a 31 de janeiro dá 28 (ou 29) de fevereiro: o PostgreSQL ajusta para o último dia do mês mais curto.

Escreva intervalos como interval '2 hours 15 minutes' ou interval '1 year'. Para um número de dias vindo de uma coluna, use interval '1 day' * n ou make_interval(days => n).

Agrupar por mês, semana ou dia com date_trunc

date_trunc(unit, value) corta um timestamp até o início do year, quarter, month, week (começando na segunda), day, hour ou minute. Agrupe por ele para contar linhas por período:

Setembro tem 2 pedidos, outubro e novembro têm 1 cada. Meses sem pedidos não aparecem no resultado; generate_series preenche esses meses com zeros.

date_trunc sobre um date retorna um timestamptz, então adicione ::date quando precisar de uma data de volta. Para faixas de qualquer tamanho, como 15 minutos, use date_bin (PostgreSQL 14+).

Extrair um campo e calcular a idade

Isso retorna 2026, 2 (terça; domingo é 0), 7200, 36 years 3 mons 28 days e 36. Outros campos incluem month, day, hour, quarter, week (número da semana ISO), isodow (segunda é 1) e epoch (segundos desde 1970 para um timestamp).

Desde o PostgreSQL 14, extract retorna numeric; a antiga date_part('year', d) retorna double precision.

age(a, b) dá a diferença em anos, meses e dias, que é o que você quer para a idade de uma pessoa. age(ts) com um único argumento mede a partir de current_date.

Formatar datas com to_char e ler com to_date

As duas primeiras retornam 2026-11-17 14:05:09 e Tuesday, 17 Nov 2026. to_date e to_timestamp leem texto no padrão que você informar. Os códigos de padrão mais comuns:

CódigoSignificadoCódigoSignificado
YYYYAno com 4 dígitosHH24Hora de 00 a 23
MMMês de 01 a 12HH12, AMRelógio de 12 horas
DDDia do mêsMIMinutos
Mon, MonthNome do mêsSSSegundos
Dy, DayNome do dia da semanaFMSem preenchimento (prefixo)

Sem FM, Day e Month são completados com espaços até 9 caracteres. MM é o mês e MI são os minutos, uma dupla fácil de confundir. to_timestamp(1763337600), com um único número, converte um valor de epoch Unix.

Perguntas frequentes

Como obter o número de dias entre duas datas no PostgreSQL?

Subtraia as duas como valores date: date '2026-12-25' - date '2026-11-17' retorna o inteiro 38. Subtrair dois timestamps retorna um interval, como 2 days 08:30:00.

Qual a diferença entre now() e current_timestamp?

Nenhuma. As duas retornam o horário de início da transação atual como timestamptz. clock_timestamp() retorna o horário real no momento da chamada, que muda até dentro de uma mesma instrução.

Como obter a data de ontem no PostgreSQL?

current_date - 1. Somar ou subtrair um inteiro de um date move a data esse número de dias e mantém o tipo date.

Como obter o último dia do mês no PostgreSQL?

Trunque para o mês, some um mês e volte um dia: (date_trunc('month', d) + interval '1 month - 1 day')::date.

Ilustração das linguagens de programação do Coddy

Aprenda a programar com o Coddy

Começar