Come funziona current_timestamp() in PostgreSQL

In PostgreSQL, il current_timestamp() La funzione restituisce la data e l'ora correnti, incluso l'offset del fuso orario.

Il timestamp restituito si basa sull'ora di inizio della transazione corrente.

Sintassi

Puoi usarlo in uno dei seguenti modi:

current_timestamp
current_timestamp(x)

Dove x è un parametro di precisione facoltativo, che fa sì che il risultato venga arrotondato a x numero di cifre frazionarie nel campo dei secondi.

Senza un parametro di precisione (la prima sintassi), il risultato viene assegnato alla piena precisione disponibile.

Esempio:precisione totale

Ecco un esempio di base per dimostrare un risultato utilizzando tutta la precisione disponibile.

SELECT current_timestamp;

Risultato:

2020-07-01 15:42:35.630594+10

Esempio – Precisione specifica

Ecco un esempio per dimostrare come specificare la precisione.

SELECT current_timestamp(0);

Risultato:

2020-07-01 15:42:58+10

In questo esempio, ho specificato una precisione pari a zero, il che significa che non sono stati restituiti secondi frazionari.

Ecco un altro esempio in cui specifico un numero di secondi frazionari.

SELECT current_timestamp(3);

Risultato:

2020-07-01 15:43:16.644+10

Transazioni

Il timestamp effettivo si basa sull'ora di inizio della transazione corrente. Pertanto, non cambia con l'avanzamento della transazione.

Ciò consente a una singola transazione di avere una nozione coerente dell'ora "corrente", in modo che più modifiche all'interno della stessa transazione abbiano lo stesso timestamp.

Ecco un esempio che lo dimostra.

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

Ecco l'output completo del mio terminale durante l'esecuzione di quella transazione in 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

Tutti e tre i valori temporali sono identici, anche se pg_sleep() è stata utilizzata per ritardare l'esecuzione tra ogni istruzione all'interno della transazione.

Questo è in contrasto con statement_timestamp() che fa cambia ad ogni affermazione.

Più chiamate all'interno di un estratto conto

Inoltre, non cambia man mano che l'istruzione avanza.

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

Risultato (usando l'output verticale):

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

Tutti e tre i valori temporali sono identici, anche se pg_sleep() è stata utilizzata per ritardare l'esecuzione tra ogni chiamata a current_timestamp .

Questo è in contrasto con clock_timestamp() funzione, che fa cambia man mano che avanza nell'istruzione.

A proposito, ho usato l'output verticale (noto anche come output espanso) per rendere i risultati leggermente più compatti.

Puoi attivare o disattivare l'output espanso in psql usando \x .