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.4 para obter mais informações. 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

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

=> CREATE TABLE t ( c1 TEXT, c2 TIMESTAMP WITH TIME ZONE );
=> BEGIN;
=> 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);
=> END;
=> SELECT * FROM t;

        c1         |              c2
-------------------+-------------------------------
 epoch             | 1969-12-31 21:00:00-03
 infinity          | infinity
 -infinity         | -infinity
 now               | 2005-04-19 18:20:35.164293-03
 today             | 2005-04-19 00:00:00-03
 tomorrow          | 2005-04-20 00:00:00-03
 yesterday         | 2005-04-18 00:00:00-03
 CURRENT_TIMESTAMP | 2005-04-19 18:20:35.164293-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 (veja a Seção 9.7 ) 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. O PostgreSQL utiliza as funcionalidades presentes no sistema operacional para fornecer apoio à saída de zona horária, sendo que os sistemas geralmente contêm informações apenas para o período entre 1902 e 2038 (correspondendo à faixa completa de tempo de um sistema Unix convencional). timestamp with time zone e time with time zone usam informação de zona horária somente dentro desta faixa de anos, assumindo que as horas fora deste intervalo estão em UTC. Mas uma vez que o suporte a zona horária é derivado das funcionalidades do sistema operacional que está por trás, este pode tratar horário de verão e outros comportamentos especiais.

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 (DST) 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 aplicações legadas 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. As horas são convertidas para a hora local no servidor de banco de dados antes de ser enviada para o cliente e, por isso, por padrão, estão na zona horária do servidor.

Existem várias maneiras de selecionar a zona horária utilizada pelo servidor:

• A variável de ambiente TZ no hospedeiro do servidor é utilizada pelo servidor como a zona horária padrão, se nenhuma outra for especificada.
• O parâmetro de configuração timezone pode ser definido no arquivo postgresql.conf.
• A variável de ambiente PGTZ, quando definida no cliente, é utilizada pelas aplicações que utilizam a libpq para enviar o comando SET TIME ZONE para o servidor durante a conexão.
• O comando SQL SET TIME ZONE define a zona horária para a sessã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.