No PostgreSQL, o
localtime
A função retorna a hora local do dia, sem o deslocamento do fuso horário. Se você precisar do deslocamento de fuso horário, use
current_time()
em vez de. Sintaxe
Você pode usá-lo de uma das seguintes maneiras:
localtime
localtime(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 localtime;
Resultado:
15:50:25.314626
Exemplo – Precisão Específica
Aqui está um exemplo para demonstrar como especificar a precisão.
SELECT localtime(0);
Resultado:
15:50:44
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 localtime(3);
Resultado:
15:50:59.039
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 localtime;
SELECT pg_sleep(5);
SELECT localtime;
SELECT pg_sleep(5);
SELECT localtime;
COMMIT;
Aqui está a saída completa do meu terminal ao executar essa transação no psql:
postgres=# BEGIN; BEGIN postgres=# SELECT localtime; localtime ----------------- 09:22:40.096909 (1 row) postgres=# SELECT pg_sleep(5); pg_sleep ---------- (1 row) postgres=# SELECT localtime; localtime ----------------- 09:22:40.096909 (1 row) postgres=# SELECT pg_sleep(5); pg_sleep ---------- (1 row) postgres=# SELECT localtime; localtime ----------------- 09:22:40.096909 (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
localtime,
pg_sleep(5),
localtime,
pg_sleep(5),
localtime;
Resultado (usando saída vertical):
localtime | 09:23:45.108559 pg_sleep | localtime | 09:23:45.108559 pg_sleep | localtime | 09:23:45.108559
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 localtime
. 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
.