Hur LocalTimeStamp() fungerar i PostgreSQL

I PostgreSQL, localtimestamp() funktionen returnerar lokalt datum och tid, utan tidszonförskjutning.

Om du behöver tidszonförskjutningen, använd current_timestamp() istället.

Syntax

Du kan använda den på något av följande sätt:

localtimestamp
localtimestamp(x)

Där x är en valfri precisionsparameter som gör att resultatet avrundas till x antal bråksiffror i sekundfältet.

Utan en precisionsparameter (den första syntaxen) ges resultatet till full tillgänglig precision.

Exempel – Full precision

Här är ett grundläggande exempel för att demonstrera ett resultat med den fulla tillgängliga precisionen.

SELECT localtimestamp;

Resultat:

2020-07-01 15:55:48.039777

Exempel – Specifik precision

Här är ett exempel för att visa hur man anger precisionen.

SELECT localtimestamp(0);

Resultat:

2020-07-01 15:56:02

I det här exemplet angav jag en precision på noll, vilket betyder att inga bråkdelar returnerades.

Här är ett annat exempel där jag anger ett antal bråkdelar.

SELECT localtimestamp(3);

Resultat:

2020-07-01 15:56:14.771

Transaktioner

Den faktiska tidsstämpeln baseras på starttiden för den aktuella transaktionen. Därför ändras det inte när transaktionen fortskrider.

Detta tillåter en enskild transaktion att ha en konsekvent uppfattning om den "aktuella" tiden, så att flera ändringar inom samma transaktion har samma tidsstämpel.

Här är ett exempel som visar detta.

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

Här är hela utdata från min terminal när jag kör den transaktionen i psql:

postgres=# BEGIN;
BEGIN
postgres=# SELECT localtimestamp;
      localtimestamp      
--------------------------
 2020-07-02 09:25:38.3858
(1 row)


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


postgres=# SELECT localtimestamp;
      localtimestamp      
--------------------------
 2020-07-02 09:25:38.3858
(1 row)


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


postgres=# SELECT localtimestamp;
      localtimestamp      
--------------------------
 2020-07-02 09:25:38.3858
(1 row)


postgres=# COMMIT;
COMMIT

Alla tre tidsvärdena är identiska, även om pg_sleep() funktion användes för att fördröja exekvering mellan varje sats i transaktionen.

Detta är i motsats till statement_timestamp() vilket gör ändra med varje påstående.

Flera samtal inom ett kontoutdrag

Det ändras inte heller när uttalandet fortskrider.

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

Resultat (med vertikal utdata):

localtimestamp | 2020-07-02 09:26:46.743801
pg_sleep       | 
localtimestamp | 2020-07-02 09:26:46.743801
pg_sleep       | 
localtimestamp | 2020-07-02 09:26:46.743801

Alla tre tidsvärdena är identiska, även om pg_sleep() funktionen användes för att fördröja exekvering mellan varje anrop till localtimestamp .

Detta är i motsats till clock_timestamp() funktion, som gör ändras allt eftersom det fortskrider genom uttalandet.

I det här exemplet använde jag vertikal utmatning (även känd som utökad utmatning) för att göra resultaten något mer kompakt.

Du kan växla utökad utdata i psql med \x .