B.2. Palavras chave para data e hora

A Tabela B-1 mostra os elementos reconhecidos como nomes dos meses.

A Tabela B-2 mostra os elementos reconhecidos como nomes dos dias da semana.

A Tabela B-3 mostra os elementos que servem como modificadores para várias finalidades.

A palavra chave ABSTIME é ignorada por razões históricas; em versões muito antigas do PostgreSQL, valores inválidos do tipo abstime eram informados como Invalid Abstime. Entretanto, este não é mais o caso, e esta palavra chave provavelmente será retirada em uma versão futura.

A Tabela B-4 mostra as abreviaturas de zona horária reconhecidas pelo PostgreSQL nos valores de entrada de data e hora. O PostgreSQL utiliza tabelas internas para decodificar a entrada de zona horária, porque não existe uma interface padrão do sistema operacional para fornecer acesso a informações gerais entre zonas horárias. Entretanto, o sistema operacional é utilizado para fornecer informação de zona horária para a saída.

Também tenha em mente que os nomes das zonas horárias reconhecidos por SET TIMEZONE são dependentes do sistema operacional, podendo ter pouco a ver com a Tabela B-4 . Por exemplo, alguns sistemas reconhecem valores como 'Europe/Rome' em SET TIMEZONE.

A tabela está organizada pelo deslocamento da zona horária com relação à UTC, em vez de alfabeticamente, com a finalidade de facilitar a correspondência entre a utilização local e as abreviaturas reconhecidas nos casos em que forem diferentes.

SELECT current_setting('TimeZone');
current_setting
-----------------
unknown
(1 linha)

Ao tentar especificar BRT como zona horária retornava uma mensagem de erro:

SELECT set_config('TimeZone','BRT',false);
ERROR: unrecognized time zone name: "BRT"

Como o arquivo /etc/timezone da máquina continha America/Sao_Paulo, foi utilizado este valor para especificar a zona horária no lugar de BRT, o que foi aceito pelo PostgreSQL.

SELECT set_config('TimeZone','America/Sao_Paulo',false);
set_config
-------------------
America/Sao_Paulo
(1 linha)

SELECT current_setting('TimeZone');
current_setting
-------------------
America/Sao_Paulo
(1 linha)

SELECT TIMESTAMP '2004-02-19 12:00:00' AT TIME ZONE 'GMT';
timezone
------------------------
2004-02-19 09:00:00-03
(1 linha)

Mas o valor definido desta forma só se mantinha durante a sessão do usuário. Para fazer com que valesse para todas as sessões de todos os usuários foi necessário editar o arquivo postgresql.conf e especificar timezone = 'America/Sao_Paulo'.