Trabalhando com informações de fuso horário

Análise de Séries Temporais no PostgreSQL

Jasmin Ludolf

Content Developer, DataCamp

Dados de fuso horário

TIMESTAMP: data e hora sem fuso horário
- Funciona bem com um único fuso
- Todos os horários estão em UTC
TIMESTAMPTZ: data e hora com fuso horário

Ilustração de quatro relógios marcando horas diferentes.

Nomes de fusos horários

SELECT * FROM pg_timezone_names;

| name             |abbrev|utc_offset|is_dst|
|------------------|------|----------|------|
|Africa/Abidjan    |GMT   |  00:00:00|false |
|Africa/Accra      |GMT   |  00:00:00|false |
|Africa/Addis_Ababa|EAT   |   3:00:00|false |
...

is_dst: indica se a localidade observa horário de verão

Mostrar o fuso horário

SHOW TIMEZONE;

|TimeZone       |
|---------------|
|Europe/Brussels|

Dados de fuso horário em tabelas

A tabela datetimes tem dois campos:
- datetime: TIMESTAMP
- datetimetz: TIMESTAMPTZ

INSERT INTO datetimes (datetime, datetimetz)
VALUES('2023-01-03 12:00:00','2023-01-03 12:00:00');

|datetime           |datetimetz               |
|-------------------|-------------------------|
|2023-01-03 12:00:00|2023-01-03 12:00:00+01:00|

Verificar o tipo de dado

pg_typeof(field_name): verifica o tipo de dado do campo

SELECT
    pg_typeof(datetime) AS "type of(datetime)", 
    pg_typeof(datetimetz) AS "type of(datetimetz)"
FROM datetimes;

|type of(datetime)          |type of(datetimetz)     |
|---------------------------|------------------------|
|timestamp without time zone|timestamp with time zone|

Usando informações de fuso horário

INSERT INTO datetimes (datetime, datetimetz)
VALUES('2023-01-03 12:00:00+00','2023-01-03 12:00:00+00');

SELECT * FROM datetimes;

|datetime           |datetimetz               |
|-------------------|-------------------------|
|2023-01-03 12:00:00|2023-01-03 12:00:00+01:00|
|2023-01-03 12:00:00|2023-01-03 13:00:00+01:00|

Adicionando informações de fuso horário

AT TIME ZONE: adicionar, mudar ou remover informações de fuso
- Converte o tipo entre TIMESTAMP e TIMESTAMPTZ

Adicionando um fuso horário:

SELECT 
    TIMESTAMP '2020-12-31 23:59:59' AT TIME ZONE 'Europe/London' AS added;

|added                    |
|-------------------------|
|2021-01-01 00:59:59+01:00|

Esta consulta: interpreta o timestamp, cria TIMESTAMPTZ, exibe o padrão

Alterando e removendo fusos horários

SELECT 
    '2020-12-31 23:59:59+00'::TIMESTAMPTZ AT TIME ZONE 'Europe/Paris' 
    AS shifted;

|shifted            |
|-------------------|
|2021-01-01 00:59:59|

Esta consulta: desloca o timestamp para o fuso desejado e remove a marca de fuso

Vamos praticar!

Análise de Séries Temporais no PostgreSQL