Pular para o conteúdo principal
Documentos
Sintaxe básicaFunções JSONAcionadoresGerenciamento de tabelas e esquemasFunções de cadeia de caracteresFunções matemáticasFunções de dataBancos de dadosÍndices

Funções de data

Datas e horários estão em toda parte nos dados: logins, transações, inscrições, eventos, prazos e muito mais. A capacidade de trabalhar com esse tipo de informação baseada em tempo é essencial em quase todos os aplicativos e análises. É aí que entram as funções de data do PostgreSQL.

Nesta visão geral, apresentaremos o que são as funções de data do PostgreSQL, por que são úteis e como são comumente usadas em cenários do mundo real.

O que são funções de data no PostgreSQL?

As funções de data no PostgreSQL são ferramentas integradas que permitem que você manipule, formate e extraia informações de valores de data e hora. Essas funções ajudam você a responder a perguntas como:

  • Em que dia da semana foi essa data?

  • Quantos dias faltam para um evento?

  • Qual é a diferença entre dois registros de data e hora?

  • Posso arredondar um registro de data e hora para o início do mês?

O PostgreSQL tem um forte suporte a vários tipos de data e hora - como DATE, TIME, TIMESTAMP e TIMESTAMPTZ (timestamp com fuso horário) - bem como um amplo conjunto de funções e operadores para trabalhar com eles.

Por que as funções de data são úteis?

Trabalhar com datas é mais do que apenas exibir um valor de calendário. Trata-se de obter insight e controle sobre como seus dados se comportam ao longo do tempo.

As funções de data permitem que você:

  • Agrupar e filtrar dados por períodos de tempo (dia, semana, mês, etc.)

  • Calcular diferenças de tempo e durações

  • Formatar datas para relatórios e exportações

  • Lidar com fusos horários e eventos globais com precisão

  • Automatize programações, lembretes ou monitoramento recorrentes

Eles também facilitam a elaboração de consultas mais expressivas, precisas e dinâmicas ao lidar com dados relacionados ao tempo.

Casos de uso no mundo real

As funções de data são usadas em muitos setores e sistemas. Por exemplo:

  • No comércio eletrônico, para calcular o tempo de vida do cliente ou o tempo desde a última compra

  • Em finanças, para agrupar a receita por trimestre ou prever fluxos de caixa futuros

  • No setor de saúde, para verificar se uma receita está vencida ou quanto tempo se passou desde uma consulta

  • Em plataformas SaaS, para gerar relatórios de atividade ou identificar o risco de rotatividade com base na inatividade

  • No gerenciamento de projetos, para calcular os dias restantes ou o tempo gasto nas tarefas

Qualquer aplicativo que registre eventos, agende tarefas ou gere relatórios sobre dados históricos pode se beneficiar dos recursos de tratamento de tempo do PostgreSQL.

O que você aprenderá nesta seção?

Esta seção da documentação apresenta as ferramentas essenciais de data e hora fornecidas pelo PostgreSQL. Os tópicos incluem:

  • Entendendo os principais tipos de dados: DATE, TIME, TIMESTAMP, TIMESTAMPTZ

  • Usando valores do sistema como CURRENT_DATE e CURRENT_TIMESTAMP

  • Extração de partes da data com EXTRACT

  • Truncando datas com DATE_TRUNC

  • Adição e subtração de datas e horas

  • Trabalhando com intervalos

  • Formatação com TO_CHAR

  • Manipulação de conversões de fuso horário

Cada tópico incluirá exemplos práticos, para que você possa ver imediatamente como essas funções se aplicam a cenários reais.