In MariaDB, UTC_TIMESTAMP()
is een ingebouwde datum- en tijdfunctie die de huidige UTC-datum en -tijd retourneert.
Het resultaat wordt geretourneerd in de indeling 'JJJJ-MM-DD UU:MM:SS' of JJJJMMDDHHMMSS.uuuuuu, afhankelijk van of de functie wordt gebruikt in een tekenreeks- of numerieke context.
UTC staat voor Coordinated Universal Time en is de wereldstandaard voor het reguleren van tijd.
Syntaxis
UTC_TIMESTAMP()
kan op de volgende twee manieren worden aangeroepen:
UTC_TIMESTAMP
UTC_TIMESTAMP([precision])
Waar precision
is een optioneel argument dat de te gebruiken precisie in microseconden specificeert.
Voorbeeld
Hier is een voorbeeld:
SELECT
UTC_TIMESTAMP,
UTC_TIMESTAMP();
Resultaat:
+---------------------+---------------------+ | UTC_TIMESTAMP | UTC_TIMESTAMP() | +---------------------+---------------------+ | 2021-06-01 22:54:53 | 2021-06-01 22:54:53 | +---------------------+---------------------+
Precisie
Hier is een voorbeeld dat de te gebruiken precisie specificeert:
SELECT
UTC_TIMESTAMP(3),
UTC_TIMESTAMP(6);
Resultaat:
+-------------------------+----------------------------+ | UTC_TIMESTAMP(3) | UTC_TIMESTAMP(6) | +-------------------------+----------------------------+ | 2021-06-01 22:55:09.880 | 2021-06-01 22:55:09.880201 | +-------------------------+----------------------------+
Numerieke context
Bij gebruik in een numerieke context, UTC_TIMESTAMP()
geeft zijn waarde terug in de indeling JJJJMMDDHHMMSS.uuuuuu:
SELECT
UTC_TIMESTAMP(6),
UTC_TIMESTAMP(6) + 0;
Resultaat:
+----------------------------+-----------------------+ | UTC_TIMESTAMP(6) | UTC_TIMESTAMP(6) + 0 | +----------------------------+-----------------------+ | 2021-06-01 23:00:50.105119 | 20210601230050.105119 | +----------------------------+-----------------------+
Ongeldige argumenten
Het doorgeven van een ongeldig argument resulteert in een fout:
SELECT UTC_TIMESTAMP('Six');
Resultaat:
ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near ''Six')' at line 1