Dans MariaDB, UTC_TIMESTAMP()
est une fonction de date et d'heure intégrée qui renvoie la date et l'heure UTC actuelles.
Le résultat est renvoyé au format "AAAA-MM-JJ HH:MM:SS" ou AAAAMMJJHHMMSS.uuuuuu, selon que la fonction est utilisée dans un contexte de chaîne ou numérique.
UTC est l'abréviation de Coordinated Universal Time et est la norme mondiale de régulation du temps.
Syntaxe
UTC_TIMESTAMP()
peut être appelé des deux manières suivantes :
UTC_TIMESTAMP
UTC_TIMESTAMP([precision])
Où precision
est un argument facultatif qui spécifie la précision en microsecondes à utiliser.
Exemple
Voici un exemple :
SELECT
UTC_TIMESTAMP,
UTC_TIMESTAMP();
Résultat :
+---------------------+---------------------+ | UTC_TIMESTAMP | UTC_TIMESTAMP() | +---------------------+---------------------+ | 2021-06-01 22:54:53 | 2021-06-01 22:54:53 | +---------------------+---------------------+
Précision
Voici un exemple qui précise la précision à utiliser :
SELECT
UTC_TIMESTAMP(3),
UTC_TIMESTAMP(6);
Résultat :
+-------------------------+----------------------------+ | UTC_TIMESTAMP(3) | UTC_TIMESTAMP(6) | +-------------------------+----------------------------+ | 2021-06-01 22:55:09.880 | 2021-06-01 22:55:09.880201 | +-------------------------+----------------------------+
Contexte numérique
Lorsqu'il est utilisé dans un contexte numérique, UTC_TIMESTAMP()
renvoie sa valeur au format AAAAMMJJHHMMSS.uuuuuu :
SELECT
UTC_TIMESTAMP(6),
UTC_TIMESTAMP(6) + 0;
Résultat :
+----------------------------+-----------------------+ | UTC_TIMESTAMP(6) | UTC_TIMESTAMP(6) + 0 | +----------------------------+-----------------------+ | 2021-06-01 23:00:50.105119 | 20210601230050.105119 | +----------------------------+-----------------------+
Arguments invalides
La transmission d'un argument non valide entraîne une erreur :
SELECT UTC_TIMESTAMP('Six');
Résultat :
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