In PostgreSQL is de localtime
functie retourneert de lokale tijd van de dag, zonder de tijdzone-offset.
Als u de tijdzone-offset nodig heeft, gebruikt u current_time()
in plaats daarvan.
Syntaxis
Je kunt het op een van de volgende manieren gebruiken:
localtime
localtime(x)
Waar x
is een optionele precisieparameter, die ervoor zorgt dat het resultaat wordt afgerond op x
aantal gebroken cijfers in het secondenveld.
Zonder een precisieparameter (de eerste syntaxis), wordt het resultaat gegeven aan de volledig beschikbare precisie.
Voorbeeld – Volledige precisie
Hier is een eenvoudig voorbeeld om een resultaat te demonstreren met gebruikmaking van de volledig beschikbare precisie.
SELECT localtime;
Resultaat:
15:50:25.314626
Voorbeeld – Specifieke precisie
Hier is een voorbeeld om te demonstreren hoe u de precisie specificeert.
SELECT localtime(0);
Resultaat:
15:50:44
In dit voorbeeld heb ik een precisie van nul gespecificeerd, wat betekent dat er geen fractionele seconden werden geretourneerd.
Hier is nog een voorbeeld waarbij ik een aantal fractionele seconden specificeer.
SELECT localtime(3);
Resultaat:
15:50:59.039
Transacties
De werkelijke tijd is gebaseerd op de starttijd van de huidige transactie. Daarom verandert het niet naarmate de transactie vordert.
Hierdoor kan een enkele transactie een consistent idee hebben van de "huidige" tijd, zodat meerdere wijzigingen binnen dezelfde transactie hetzelfde tijdstempel dragen.
Hier is een voorbeeld dat dit aantoont.
BEGIN;
SELECT localtime;
SELECT pg_sleep(5);
SELECT localtime;
SELECT pg_sleep(5);
SELECT localtime;
COMMIT;
Hier is de volledige uitvoer van mijn terminal bij het uitvoeren van die transactie in 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
Alle drie de tijdwaarden zijn identiek, hoewel de pg_sleep()
functie werd gebruikt om de uitvoering tussen elke verklaring binnen de transactie te vertragen.
Dit in tegenstelling tot statement_timestamp()
wat doet veranderen bij elke uitspraak.
Meerdere oproepen binnen een verklaring
Het verandert ook niet naarmate de verklaring vordert.
\x
SELECT
localtime,
pg_sleep(5),
localtime,
pg_sleep(5),
localtime;
Resultaat (met verticale uitvoer):
localtime | 09:23:45.108559 pg_sleep | localtime | 09:23:45.108559 pg_sleep | localtime | 09:23:45.108559
Alle drie de tijdwaarden zijn identiek, hoewel de pg_sleep()
functie werd gebruikt om de uitvoering te vertragen tussen elke aanroep naar localtime
.
Dit in tegenstelling tot de clock_timestamp()
functie, wat doet veranderen naarmate de instructie vordert.
Ik heb trouwens verticale uitvoer gebruikt (ook bekend als uitgebreide uitvoer) om de resultaten iets compacter te maken.
U kunt uitgebreide uitvoer in psql schakelen met \x
.