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ção | Retorna | Tipo |
|---|---|---|
now(), current_timestamp | Data e hora em que a transação começou | timestamptz |
current_date | A data de hoje | date |
localtimestamp | Data e hora sem fuso horário | timestamp |
clock_timestamp() | O horário real no momento da chamada | timestamptz |
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 + integeredate - integerandam em dias e retornam umdate.date - dateretorna o número de dias como inteiro.date + intervalretorna umtimestamp; converta de volta com::datese quiser uma data.timestamp - timestampretorna uminterval.- 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ódigo | Significado | Código | Significado |
|---|---|---|---|
YYYY | Ano com 4 dígitos | HH24 | Hora de 00 a 23 |
MM | Mês de 01 a 12 | HH12, AM | Relógio de 12 horas |
DD | Dia do mês | MI | Minutos |
Mon, Month | Nome do mês | SS | Segundos |
Dy, Day | Nome do dia da semana | FM | Sem 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.