In MariaDB UTC_TIMESTAMP()
ist eine integrierte Datums- und Zeitfunktion, die das aktuelle UTC-Datum und die aktuelle UTC-Zeit zurückgibt.
Das Ergebnis wird im Format „YYYY-MM-DD HH:MM:SS“ oder YYYYMMDDHHMMSS.uuuuuu zurückgegeben, je nachdem, ob die Funktion in einem Zeichenfolgen- oder numerischen Kontext verwendet wird.
UTC steht für Coordinated Universal Time und ist der Weltstandard für die Regulierung der Zeit.
Syntax
UTC_TIMESTAMP()
kann auf zwei Arten aufgerufen werden:
UTC_TIMESTAMP
UTC_TIMESTAMP([precision])
Wobei precision
ist ein optionales Argument, das die zu verwendende Mikrosekundengenauigkeit angibt.
Beispiel
Hier ist ein Beispiel:
SELECT
UTC_TIMESTAMP,
UTC_TIMESTAMP();
Ergebnis:
+---------------------+---------------------+ | UTC_TIMESTAMP | UTC_TIMESTAMP() | +---------------------+---------------------+ | 2021-06-01 22:54:53 | 2021-06-01 22:54:53 | +---------------------+---------------------+
Präzision
Hier ist ein Beispiel, das die zu verwendende Genauigkeit angibt:
SELECT
UTC_TIMESTAMP(3),
UTC_TIMESTAMP(6);
Ergebnis:
+-------------------------+----------------------------+ | UTC_TIMESTAMP(3) | UTC_TIMESTAMP(6) | +-------------------------+----------------------------+ | 2021-06-01 22:55:09.880 | 2021-06-01 22:55:09.880201 | +-------------------------+----------------------------+
Numerischer Kontext
Bei Verwendung in einem numerischen Kontext UTC_TIMESTAMP()
gibt seinen Wert im Format YYYYMMDDHHMMSS.uuuuuu zurück:
SELECT
UTC_TIMESTAMP(6),
UTC_TIMESTAMP(6) + 0;
Ergebnis:
+----------------------------+-----------------------+ | UTC_TIMESTAMP(6) | UTC_TIMESTAMP(6) + 0 | +----------------------------+-----------------------+ | 2021-06-01 23:00:50.105119 | 20210601230050.105119 | +----------------------------+-----------------------+
Ungültige Argumente
Das Übergeben eines ungültigen Arguments führt zu einem Fehler:
SELECT UTC_TIMESTAMP('Six');
Ergebnis:
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