No PostgreSQL, o
current_timestamp()
A função retorna a data e a hora atuais, incluindo o deslocamento do fuso horário. O carimbo de data/hora retornado é baseado na hora de início da transação atual.
Sintaxe
Você pode usá-lo de uma das seguintes maneiras:
current_timestamp
current_timestamp(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_timestamp;
Resultado:
2020-07-01 15:42:35.630594+10
Exemplo – Precisão Específica
Aqui está um exemplo para demonstrar como especificar a precisão.
SELECT current_timestamp(0);
Resultado:
2020-07-01 15:42:58+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_timestamp(3);
Resultado:
2020-07-01 15:43:16.644+10
Transações
O carimbo de data/hora real é baseado 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_timestamp;
SELECT pg_sleep(5);
SELECT current_timestamp;
SELECT pg_sleep(5);
SELECT current_timestamp;
COMMIT;
Aqui está a saída completa do meu terminal ao executar essa transação no psql:
postgres=# BEGIN; BEGIN postgres=# SELECT current_timestamp; current_timestamp ------------------------------- 2020-07-02 09:02:52.952669+10 (1 row) postgres=# SELECT pg_sleep(5); pg_sleep ---------- (1 row) postgres=# SELECT current_timestamp; current_timestamp ------------------------------- 2020-07-02 09:02:52.952669+10 (1 row) postgres=# SELECT pg_sleep(5); pg_sleep ---------- (1 row) postgres=# SELECT current_timestamp; current_timestamp ------------------------------- 2020-07-02 09:02:52.952669+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_timestamp,
pg_sleep(5),
current_timestamp,
pg_sleep(5),
current_timestamp;
Resultado (usando saída vertical):
current_timestamp | 2020-07-02 09:04:03.413062+10 pg_sleep | current_timestamp | 2020-07-02 09:04:03.413062+10 pg_sleep | current_timestamp | 2020-07-02 09:04:03.413062+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_timestamp
. 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
.