Como current_time funciona no PostgreSQL

No PostgreSQL, o current_time A função retorna a hora atual, incluindo o deslocamento do fuso horário.

A hora retornada é baseada na hora de início da transação atual.

Sintaxe

Você pode usá-lo de uma das seguintes maneiras:

current_time
current_time(x)

Onde x é um parâmetro de precisão opcional, que faz com que o resultado seja arredondado para x número de dígitos fracionários no campo de segundos.

Sem um parâmetro de precisão (a primeira sintaxe), o resultado é fornecido com a precisão total disponível.

Exemplo – Precisão total

Aqui está um exemplo básico para demonstrar um resultado usando a precisão total disponível.

SELECT current_time;

Resultado:

14:33:30.731384+10

Exemplo – Precisão Específica

Aqui está um exemplo para demonstrar como especificar a precisão.

SELECT current_time(0);

Resultado:

15:35:38+10

Neste exemplo, especifiquei uma precisão de zero, o que significa que nenhum segundo fracionário foi retornado.

Aqui está outro exemplo em que especifico um número de segundos fracionários.

SELECT current_time(3);

Resultado:

15:37:43.385+10

Transações

A hora real é baseada na hora de início da transação atual. Portanto, ele não muda à medida que a transação avança.

Isso permite que uma única transação tenha uma noção consistente da hora “atual”, de modo que várias modificações na mesma transação tenham o mesmo carimbo de hora.

Aqui está um exemplo que demonstra isso.

BEGIN;
SELECT current_time;
SELECT pg_sleep(5);
SELECT current_time;
SELECT pg_sleep(5);
SELECT current_time;
COMMIT;

Aqui está a saída completa do meu terminal ao executar essa transação no psql:

postgres=# BEGIN;
BEGIN
postgres=# SELECT current_time;
    current_time    
--------------------
 09:09:27.524852+10
(1 row)


postgres=# SELECT pg_sleep(5);
SELECT current_time;
SELECT pg_sleep(5);
SELECT current_time;
COMMIT;
 pg_sleep 
----------
 
(1 row)


postgres=# SELECT current_time;
    current_time    
--------------------
 09:09:27.524852+10
(1 row)


postgres=# SELECT pg_sleep(5);
 pg_sleep 
----------
 
(1 row)


postgres=# SELECT current_time;
    current_time    
--------------------
 09:09:27.524852+10
(1 row)


postgres=# COMMIT;
COMMIT

Todos os três valores de tempo são idênticos, embora o pg_sleep() A função era usada para atrasar a execução entre cada instrução dentro da transação.

Isso contrasta com statement_timestamp() o que faz mudar a cada afirmação.

Várias chamadas em um extrato

Também não muda à medida que a declaração progride.

\x
SELECT 
  current_time,
  pg_sleep(5),
  current_time,
  pg_sleep(5),
  current_time;

Resultado (usando saída vertical):

current_time | 09:11:16.09445+10
pg_sleep     | 
current_time | 09:11:16.09445+10
pg_sleep     | 
current_time | 09:11:16.09445+10

Todos os três valores de tempo são idênticos, embora o pg_sleep() função foi usada para atrasar a execução entre cada chamada para current_time .

Isso contrasta com o clock_timestamp() função, que faz mudar à medida que progride através da declaração.

A propósito, usei a saída vertical (também conhecida como saída expandida) para tornar os resultados um pouco mais compactos.

Você pode alternar a saída expandida no psql usando \x .