Guia de formatação de datas no PostgreSQL

No mundo dos bancos de dados SQL, o PostgreSQL é amplamente conhecido por sua robustez e pelo rico conjunto de recursos. Um desses recursos é o forte suporte a tipos de data e timestamp. Neste guia, vamos explorar como formatar datas no PostgreSQL, com exemplos de código. Este tutorial é voltado para engenheiros de software e outras pessoas com perfil técnico que querem ampliar seus conhecimentos de PostgreSQL.

Entendendo datas no PostgreSQL

Antes de mergulhar em como formatar datas, é fundamental entender como as datas são representadas no PostgreSQL. O PostgreSQL usa o tipo de dado “Date” para armazenar datas. Veja como criar uma tabela com uma coluna DATE.

CREATE TABLE orders (
  order_id serial PRIMARY KEY,
  order_date DATE NOT NULL
);

Agora, vamos inserir alguns dados na tabela orders.

INSERT INTO orders (order_date) VALUES 
('2022-04-01'),
('2022-04-02'),
('2022-04-03');

O PostgreSQL é esperto e consegue interpretar uma data a partir de uma string se você fornecer a data no formato ISO 6801.

Como formatar datas no PostgreSQL: usando a função TO_CHAR

O principal método para formatar datas no PostgreSQL é a função TO_CHAR. A TO_CHAR permite formatar tipos de data/hora em uma string com um padrão específico. Veja como usá-la:

TO_CHAR(date, format)

A lista completa de opções de formatação está disponível na documentação do PostgreSQL. Estas são as opções de formatação em janeiro de 2024:

Exemplos de formatação de datas

Vamos começar convertendo nossa data em uma string simples e legível. Veja como fazer:

SELECT order_id, TO_CHAR(order_date, 'DD Mon YYYY') as formatted_date
FROM orders;

A saída ficaria assim:

order_id | formatted_date
———+—————-
1 | 13 Jan 2024
2 | 12 Jan 2024
3 | 11 Jan 2024
4 | 10 Jan 2024
5 | 09 Jan 2024

Também podemos extrair apenas uma parte da data:

SELECT order_id, TO_CHAR(order_date, 'Day') as day_of_week
FROM orders;

order_id | day_of_week
———+————-
1 | Friday
2 | Thursday
3 | Wednesday
4 | Tuesday
5 | Monday

Podemos até combinar formatos, se quisermos:

SELECT order_id, TO_CHAR(order_date, 'Day, DD Mon YYYY') as detailed_date
FROM orders;

order_id | detailed_date
———+————————
1 | Friday, 13 Jan 2024
2 | Thursday, 12 Jan 2024
3 | Wednesday, 11 Jan 2024
4 | Tuesday, 10 Jan 2024
5 | Monday, 09 Jan 2024

Função EXTRACT

A função EXTRACT oferece acesso fácil a todas as partes possíveis de um valor de data/hora, como ano, mês, dia etc.

SELECT order_id, EXTRACT(MONTH from order_date) as order_month
FROM orders;

order_id | order_month
———+————
1 | 1
2 | 1
3 | 1
4 | 1
5 | 1

Esse é o básico da formatação de datas no PostgreSQL. Essas ferramentas devem dar uma base sólida para lidar com dados de data. Como tudo em programação, a prática é essencial: teste esses comandos você mesmo e veja o que mais consegue criar. Bom código!

Você deveria mesmo experimentar rodar essas consultas no Beekeeper Studio. :-)