In PostgreSQL, de current_timestamp()
functie retourneert de huidige datum en tijd, inclusief de tijdzone-offset.
Het geretourneerde tijdstempel is gebaseerd op de starttijd van de huidige transactie.
Syntaxis
Je kunt het op een van de volgende manieren gebruiken:
current_timestamp
current_timestamp(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 current_timestamp;
Resultaat:
2020-07-01 15:42:35.630594+10
Voorbeeld – Specifieke precisie
Hier is een voorbeeld om te demonstreren hoe u de precisie specificeert.
SELECT current_timestamp(0);
Resultaat:
2020-07-01 15:42:58+10
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 current_timestamp(3);
Resultaat:
2020-07-01 15:43:16.644+10
Transacties
De werkelijke tijdstempel 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 current_timestamp;
SELECT pg_sleep(5);
SELECT current_timestamp;
SELECT pg_sleep(5);
SELECT current_timestamp;
COMMIT;
Hier is de volledige uitvoer van mijn terminal bij het uitvoeren van die transactie 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
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
current_timestamp,
pg_sleep(5),
current_timestamp,
pg_sleep(5),
current_timestamp;
Resultaat (met verticale uitvoer):
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
Alle drie de tijdwaarden zijn identiek, hoewel de pg_sleep()
functie werd gebruikt om de uitvoering te vertragen tussen elke aanroep naar current_timestamp
.
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
.