6.8. Funções e operadores para data e hora

6.8.1. EXTRACT, date_part

EXTRACT (campo FROM fonte)

A função extract obtém subcampos dos valores de data e hora, como o ano ou a hora. A fonte é uma expressão de valor avaliada aos tipos timestamp ou interval. (As expressões do tipo date e time são transformadas em timestamp, possibilitando utilizá-las da mesma forma). O campo é um identificador, ou uma cadeia de caracteres, que seleciona qual campo será extraído do valor fonte. A função extract retorna valores do tipo double precision. Abaixo são mostrados valores válidos:

A função extract é voltada principalmente para o processamento computacional. Para formatar valores de data e hora para exibição, veja a Seção 6.7.

A função date_part está modelada sobre o equivalente no Ingres à função extract do padrão SQL:

date_part('campo', fonte)

Observe que neste caso o parâmetro campo precisa ser um uma cadeia de caracteres, e não um nome. Os valores válidos para campo em date_part são os mesmos da função extract.

SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
Resultado: 16

SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
Resultado: 4

6.8.2. date_trunc

A função date_trunc é conceitualmente similar à função trunc para números.

date_trunc('campo', fonte)

fonte é uma expressão de valor do tipo timestamp (valores do tipo date e time são transformados automaticamente). campo seleciona a precisão a ser utilizada para truncar o valor do carimbo de tempo. O valor retornado é do tipo timestamp, com todos os campos inferiores ao valor selecionado tornados zero (ou um, para o dia do mês).

Os valores válidos para campo são:

Exemplos:

SELECT date_trunc('hour', TIMESTAMP '2001-02-16 20:38:40');
Resultado: 2001-02-16 20:00:00+00

SELECT date_trunc('year', TIMESTAMP '2001-02-16 20:38:40');
Resultado: 2001-01-01 00:00:00+00

6.8.3. AT TIME ZONE

A construção AT TIME ZONE permite a conversão do carimbo de tempo para uma zona horária diferente.

Nestas expressões, a zona horária desejada pode ser especificada tanto por meio de um texto em uma cadeia de caracteres (por exemplo, 'PST') quanto por um intervalo (por exemplo, INTERVAL '-08:00').

Exemplos (suponha que a TimeZone seja PST8PDT):

SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'MST';
Resultado: 2001-02-16 19:38:40-08

SELECT TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-05' AT TIME ZONE 'MST';
Resultado: 2001-02-16 18:38:40

O primeiro exemplo aceita um carimbo de tempo sem zona horária e o interpreta como hora MST (GMT-7) para produzir um carimbo de tempo UTC, o qual é então rotacionado para PST (GMT-8) para ser exibido. O segundo exemplo aceita um carimbo de tempo especificado em EST (GMT-5) e converte para hora local MST (GMT-7).

A função timezone(zona, carimbo_de_tempo) equivale à construção em conformidade com o padrão SQL carimbo_de_tempo AT TIME ZONE zona.

6.8.4. Data e hora corrente

As seguintes funções estão disponíveis para obtenção da data e hora corrente:

CURRENT_DATE
CURRENT_TIME
CURRENT_TIMESTAMP
CURRENT_TIME ( precisão )
CURRENT_TIMESTAMP ( precisão )
LOCALTIME
LOCALTIMESTAMP
LOCALTIME ( precisão )
LOCALTIMESTAMP ( precisão )

CURRENT_TIME e CURRENT_TIMESTAMP fornecem valores com zona horária; LOCALTIME e LOCALTIMESTAMP fornecem valores sem zona horária.

CURRENT_TIME, CURRENT_TIMESTAMP, LOCALTIME e LOCALTIMESTAMP podem, opcionalmente, receber um parâmetro com a precisão fazendo o resultado ser arredondado nesta quantidade de dígitos fracionários. Sem o parâmetro de precisão, o resultado é fornecido com toda a precisão disponível.

Alguns exemplos:

SELECT CURRENT_TIME;
14:39:53.662522-05

SELECT CURRENT_DATE;
2001-12-23

SELECT CURRENT_TIMESTAMP;
2001-12-23 14:39:53.662522-05

SELECT CURRENT_TIMESTAMP(2);
2001-12-23 14:39:53.66-05

SELECT LOCALTIMESTAMP;
2001-12-23 14:39:53.662522

A função now() é o equivalente tradicional do PostgreSQL para CURRENT_TIMESTAMP.

Também existe a função timeofday(), que por motivos históricos retorna uma cadeia de caracteres e não um valor do tipo timestamp:

SELECT timeofday();
 Sat Feb 17 19:07:32.000126 2001 EST

É importante perceber que CURRENT_TIMESTAMP e as funções relacionadas retornam o tempo do começo da transação corrente; seus valores não mudam durante a transação. A função timeofday() retorna a hora corrente, avançando durante as transações.

Todos os tipos de dado para data e hora também aceitam o valor literal especial now para especificar a data e hora corrente. Portanto, os três comandos abaixo retornam o mesmo resultado:

SELECT CURRENT_TIMESTAMP;
SELECT now();
SELECT TIMESTAMP 'now';