O PostgreSQL tem dois tipos de timestamp. timestamptz (timestamp with time zone) guarda um instante exato: é convertido para UTC na entrada e mostrado no fuso horário da sessão na saída. timestamp (timestamp without time zone) guarda uma data e um horário de relógio sem fuso. Nenhum dos dois guarda o fuso que você escreveu. Para tudo que aconteceu num momento específico, use timestamptz.
A mesma entrada dá 2026-03-01 12:00:00 e 2026-03-01 21:00:00+09. O valor timestamptz é o mesmo instante de antes, agora mostrado no horário de Tóquio. O valor timestamp não tem fuso de onde converter, então não muda.
O que acontece com o fuso horário da entrada
Quando a entrada traz um offset, o timestamptz o usa para encontrar o instante. O timestamp o descarta sem avisar:
plain é 2026-03-01 12:00:00, com o +02 jogado fora. with_zone é 2026-03-01 10:00:00+00, o mesmo instante em UTC. É assim que os horários acabam deslocados em horas: a aplicação manda uma string ISO com offset para uma coluna timestamp, e o offset some.
Quando usar cada um
| Uso | Tipo |
|---|---|
| Criado, atualizado, pago, fez login | timestamptz |
| Um horário local agendado que segue o relógio local ("9:00 todo dia no fuso do usuário") | timestamp mais uma coluna com o nome do fuso |
| Um dia do calendário sem horário | date |
| Uma duração | interval |
Os dois tipos ocupam 8 bytes e guardam microssegundos. Defina o fuso da sessão com SET TIME ZONE 'Europe/Paris'. Use nomes completos de fuso, não abreviações como EST: uma abreviação é um offset fixo que ignora o horário de verão.
Converter entre fusos com AT TIME ZONE
AT TIME ZONE funciona nos dois sentidos. Num timestamptz, retorna o horário de relógio naquele fuso, como timestamp. Num timestamp, lê o valor como horário local daquele fuso e retorna o instante timestamptz.
Meio-dia UTC são 08:00 em Nova York em julho, e 9:00 em Paris são 07:00 UTC. Use a primeira forma para mostrar um horário no fuso do usuário, e a segunda para transformar em instante um horário local que o usuário digitou.
Horário de verão e aritmética com intervalos
Somar interval '1 day' a um timestamptz mantém o mesmo horário de relógio local quando o horário de verão muda. Somar '24 hours' soma horas exatas. Nos Estados Unidos, os relógios adiantam em 8 de março de 2026:
O primeiro dá 2026-03-08 12:00:00-04, o segundo 2026-03-08 13:00:00-04. O resultado depende do fuso horário da sessão, então defina-o explicitamente no código que faz contas com datas.
Horário atual
now() e current_timestamp retornam o horário de início da transação atual como timestamptz, o mesmo valor para todas as linhas que um comando altera. clock_timestamp() retorna o horário real a cada chamada. current_date retorna um date, e localtimestamp um timestamp. Uma coluna típica é created_at timestamptz NOT NULL DEFAULT now().
Converter uma coluna timestamp para timestamptz
Se uma coluna timestamp existente guarda horários em UTC, converta com USING ... AT TIME ZONE 'UTC', para que os valores sejam lidos como UTC e não no fuso da sessão:
Agora o valor é 2026-01-15 09:30:00+01, mostrado no horário de Berlim. A alteração reescreve a tabela, então numa tabela grande rode num momento tranquilo (ALTER TABLE mostra mudanças de tipo). Funções como date_trunc, extract e age estão na página de funções de data, e o capítulo de tipos de data e hora tem todos os formatos de entrada.
Perguntas frequentes
O timestamptz guarda o fuso horário no PostgreSQL?
Não. Ele converte a entrada para UTC e guarda só esse instante. O fuso que você escreveu se perde; a saída aparece de acordo com a configuração TimeZone da sessão. Guarde o nome do fuso numa coluna text separada se precisar dele depois.
Qual a diferença entre now() e clock_timestamp()?
now() (o mesmo que current_timestamp) retorna o horário de início da transação atual, então é igual para todas as linhas e comandos dentro dela. clock_timestamp() retorna o horário real no momento da chamada e muda até dentro de um único comando.
Como pegar a data atual no PostgreSQL?
current_date retorna a data de hoje no fuso horário da sessão. now()::date dá o mesmo resultado, e localtimestamp retorna a data e hora atuais como um timestamp sem fuso.
Quanto espaço um timestamp ocupa no PostgreSQL?
8 bytes, tanto timestamp quanto timestamptz, com resolução de microssegundos. date ocupa 4 bytes.