Hur LocalTime() fungerar i PostgreSQL

I PostgreSQL, localtime funktionen returnerar den lokala tiden på dygnet, utan tidszonsförskjutning.

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

Syntax

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

localtime
localtime(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 localtime;

Resultat:

15:50:25.314626

Exempel – Specifik precision

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

SELECT localtime(0);

Resultat:

15:50:44

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 localtime(3);

Resultat:

15:50:59.039

Transaktioner

Den faktiska tiden 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 localtime;
SELECT pg_sleep(5);
SELECT localtime;
SELECT pg_sleep(5);
SELECT localtime;
COMMIT;

Här är hela utdata från min terminal när jag kör den transaktionen i 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

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 
  localtime,
  pg_sleep(5),
  localtime,
  pg_sleep(5),
  localtime;

Resultat (med vertikal utdata):

localtime | 09:23:45.108559
pg_sleep  | 
localtime | 09:23:45.108559
pg_sleep  | 
localtime | 09:23:45.108559

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

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

Förresten, jag använde 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 .