Dans MariaDB, UTC_TIME()
est une fonction de date et d'heure intégrée qui renvoie l'heure UTC actuelle.
Le résultat est renvoyé au format ‘HH:MM:SS’ ou HHMMSS.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_TIME()
peut être appelé des deux manières suivantes :
UTC_TIME
UTC_TIME([precision])
Où precision
est un argument facultatif qui spécifie la précision en microsecondes à utiliser.
Exemple
Voici un exemple :
SELECT
UTC_TIME,
UTC_TIME();
Résultat :
+----------+------------+ | UTC_TIME | UTC_TIME() | +----------+------------+ | 00:17:09 | 00:17:09 | +----------+------------+
Précision
Voici un exemple qui précise la précision à utiliser :
SELECT
UTC_TIME(3),
UTC_TIME(6);
Résultat :
+--------------+-----------------+ | UTC_TIME(3) | UTC_TIME(6) | +--------------+-----------------+ | 00:18:21.667 | 00:18:21.667957 | +--------------+-----------------+
Contexte numérique
Lorsqu'il est utilisé dans un contexte numérique, UTC_TIME()
renvoie sa valeur au format HHMMSS.uuuuuu :
SELECT
UTC_TIME(6),
UTC_TIME(6) + 0;
Résultat :
+-----------------+-----------------+ | UTC_TIME(6) | UTC_TIME(6) + 0 | +-----------------+-----------------+ | 23:01:18.921377 | 230118.921377 | +-----------------+-----------------+
Arguments invalides
La transmission d'un argument non valide entraîne une erreur :
SELECT UTC_TIME('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