8.5. Tipos para data e hora

8.5.1. Entrada de data e hora

A entrada da data e da hora é aceita em praticamente todos os formatos razoáveis, incluindo o ISO 8601, o SQL-compatível, o POSTGRES tradicional, além de outros. Para alguns formatos a ordem do dia, mês e ano na entrada da data é ambíguo e, por isso, existe suporte para especificar a ordem esperada destes campos. Deve ser definido o parâmetro DateStyle como MDY para selecionar a interpretação mês-dia-ano, DMY para selecionar a interpretação dia-mês-ano, ou YMD para selecionar a interpretação ano-mês-dia.

O PostgreSQL é mais flexível no tratamento da entrada de data e hora do que o requerido pelo padrão SQL. Consulte o Apêndice B para conhecer as regras exatas de análise da entrada de data e hora e os campos texto reconhecidos, incluindo meses, dias da semana e zonas horárias.

Lembre-se que qualquer entrada literal de data ou hora necessita estar entre apóstrofos, como os textos das cadeias de caracteres. Consulte a Seção 4.1.2.5 para obter informações adicionais. O SQL requer a seguinte sintaxe

tipo [ (p) ] 'valor'

onde p, na especificação opcional da precisão, é um número inteiro correspondendo ao número de dígitos fracionários do campo de segundos. A precisão pode ser especificada para os tipos time, timestamp e interval. Os valores permitidos estão mencionados acima. Se não for especificada nenhuma precisão na especificação da constante, a precisão do valor literal torna-se o padrão.

1999-01-08 04:05:06

1999-01-08 04:05:06 -8:00

January 8 04:05:06 1999 PST

TIMESTAMP '2004-10-19 10:23:54'

TIMESTAMP '2004-10-19 10:23:54+02'

TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'

[@] quantidade unidade [quantidade unidade...] [direção]

BEGIN;
CREATE TEMPORARY TABLE t ( c1 TEXT, c2 TIMESTAMP WITH TIME ZONE ) ON COMMIT DROP;
INSERT INTO t VALUES ('epoch', 'epoch');
INSERT INTO t VALUES ('infinity', 'infinity');
INSERT INTO t VALUES ('-infinity', '-infinity');
INSERT INTO t VALUES ('now', 'now');
INSERT INTO t VALUES ('today', 'today');
INSERT INTO t VALUES ('tomorrow', 'tomorrow');
INSERT INTO t VALUES ('yesterday', 'yesterday');
INSERT INTO t VALUES ('CURRENT_TIMESTAMP', CURRENT_TIMESTAMP);
SELECT * FROM t;
COMMIT;

        c1         |             c2
-------------------+----------------------------
 epoch             | 1969-12-31 21:00:00-03
 infinity          | infinity
 -infinity         | -infinity
 now               | 2007-03-04 09:10:20.234-03
 today             | 2007-03-04 00:00:00-03
 tomorrow          | 2007-03-05 00:00:00-03
 yesterday         | 2007-03-03 00:00:00-03
 CURRENT_TIMESTAMP | 2007-03-04 09:10:20.234-03
(8 linhas)

8.5.2. Saídas de data e hora

Utilizando o comando SET datestyle o formato de saída para os tipos de data e hora pode ser definido como um dos quatro estilos ISO 8601, SQL (Ingres), POSTGRES tradicional e German. O padrão é o formato ISO (o padrão SQL requer a utilização do formato ISO 8601; o nome do formato de saída "SQL" é um acidente histórico). A Tabela 8-14 mostra exemplo de cada um dos estilos de saída. A saída dos tipos date e time obviamente utilizam apenas a parte da data ou da hora de acordo com os exemplos fornecidos.

Nos estilos SQL e POSTGRES, o dia vem antes do mês se a ordem de campo DMY tiver sido especificada, senão o mês vem antes do dia (veja na Seção 8.5.1 como esta especificação também afeta a interpretação dos valores de entrada). A Tabela 8-15 mostra um exemplo.

A saída do tipo interval se parece com o formato da entrada, exceto que as unidades como century e week são convertidas em anos e dias, e que ago é convertido no sinal apropriado. No modo ISO a saída se parece com

[ quantidade unidade [ ... ] ] [ dias ] [ horas:minutos:segundos ]

Os estilos de data e hora podem ser selecionados pelo usuário utilizando o comando SET datestyle, o parâmetro DateStyle no arquivo de configuração postgresql.conf, ou a variável de ambiente PGDATESTYLE no servidor ou no cliente. A função de formatação to_char (consulte a Seção 9.8) também pode ser utilizada como uma forma mais flexível de formatar a saída de data e hora.

8.5.3. Zonas horárias

Zonas horárias e convenções de zonas horárias são influenciadas por decisões políticas, e não apenas pela geometria da Terra. As zonas horárias em torno do mundo se tornaram um tanto padronizadas durante o século XX, mas continuam propensas a mudanças arbitrárias, particularmente com relação a horários de inverno e de verão. Atualmente o PostgreSQL suporta as regras de horário de inverno e verão (daylight-savings rules) no período de tempo que vai de 1902 até 2038 (correspondendo à faixa completa de tempo do sistema Unix convencional). Datas fora desta faixa são consideradas como estando na "hora padrão" da zona horária selecionada, sem importar em que parte do ano se encontram.

O PostgreSQL se esforça para ser compatível com as definições do padrão SQL para o uso típico. Entretanto, o padrão SQL possui uma combinação única de tipos e funcionalidades para data e hora. Os dois problemas óbvios são:

• Embora o tipo date não possua zona horária associada, o tipo time pode possuir. As zonas horárias do mundo real possuem pouco significado a menos que estejam associadas a uma data e hora, porque o deslocamento pode variar durante o ano devido ao horário de verão.

• A zona horária padrão é especificada como um deslocamento numérico constante em relação ao UTC. Não é possível, portanto, fazer ajuste devido ao horário de verão ao se realizar aritmética de data e hora entre fronteiras do horário de verão (DST). [3]

Para superar estas dificuldades, recomenda-se utilizar tipos de data e hora contendo tanto a data quanto a hora quando utilizar zonas horárias. Recomenda-se não utilizar o tipo time with time zone (embora seja suportado pelo PostgreSQL para os aplicativos legados e para conformidade com o padrão SQL). O PostgreSQL assume a zona horária local para qualquer tipo contendo apenas a data ou a hora.

Todas as datas e horas com zona horária são armazenadas internamente em UTC. São convertidas para a hora local na zona especificada pelo parâmetro de configuração timezone antes de serem mostradas ao cliente.

O parâmetro de configuração timezone pode ser definido no arquivo postgresql.conf, ou por qualquer outro meio padrão descrito na Seção 16.4. Existem, também, várias outras formas especiais de defini-lo:

• Se timezone não for especificada no arquivo de configuração postgresql.conf, nem como uma chave da linha de comando do postmaster, o servidor tenta utilizar o valor da variável de ambiente TZ como a zona horária padrão. Se TZ não estiver definida, ou não contiver nenhum nome de zona horária conhecido pelo PostgreSQL, o servidor tenta determinar a zona horária padrão do sistema operacional verificando o comportamento da função localtime() da biblioteca C. A zona horária padrão é selecionada através da correspondência mais próximas entre as zonas horárias conhecidas pelo PostgreSQL.

• O comando SQL SET TIME ZONE define a zona horária para a sessão. Esta é uma forma alternativa de SET TIMEZONE TO com uma sintaxe mais compatível com a especificação SQL.

• Se a variável de ambiente PGTZ estiver definida no cliente, é utilizada pelos aplicativos libpq para enviar o comando SET TIME ZONE para o servidor durante a conexão.

Consulte o Apêndice B para obter a lista de zonas horárias disponíveis.

8.5.4. Internamente

O PostgreSQL utiliza datas Julianas [4] para todos os cálculos de data e hora, porque possuem a boa propriedade de predizer/calcular corretamente qualquer data mais recente que 4713 AC até bem distante no futuro, partindo da premissa que o ano possui 365,2425 dias.

As convenções de data anteriores ao século 19 são uma leitura interessante, mas não são suficientemente consistentes para permitir a codificação em rotinas tratadoras de data e hora.