V MariaDB, UTC_TIMESTAMP()
je vestavěná funkce data a času, která vrací aktuální datum a čas UTC.
Výsledek je vrácen ve formátu „RRRR-MM-DD HH:MM:SS“ nebo YYYYMMDDHHMMSS.uuuuuu v závislosti na tom, zda je funkce použita v řetězcovém nebo číselném kontextu.
UTC je zkratka pro Coordinated Universal Time a je světovým standardem pro regulaci času.
Syntaxe
UTC_TIMESTAMP()
lze volat následujícími dvěma způsoby:
UTC_TIMESTAMP
UTC_TIMESTAMP([precision])
Kde precision
je volitelný argument, který určuje přesnost na mikrosekundy, která se má použít.
Příklad
Zde je příklad:
SELECT
UTC_TIMESTAMP,
UTC_TIMESTAMP();
Výsledek:
+---------------------+---------------------+ | UTC_TIMESTAMP | UTC_TIMESTAMP() | +---------------------+---------------------+ | 2021-06-01 22:54:53 | 2021-06-01 22:54:53 | +---------------------+---------------------+
Přesnost
Zde je příklad, který specifikuje přesnost použití:
SELECT
UTC_TIMESTAMP(3),
UTC_TIMESTAMP(6);
Výsledek:
+-------------------------+----------------------------+ | UTC_TIMESTAMP(3) | UTC_TIMESTAMP(6) | +-------------------------+----------------------------+ | 2021-06-01 22:55:09.880 | 2021-06-01 22:55:09.880201 | +-------------------------+----------------------------+
Číselný kontext
Při použití v číselném kontextu UTC_TIMESTAMP()
vrátí svou hodnotu ve formátu YYYYMMDDHHMMSS.uuuuuu:
SELECT
UTC_TIMESTAMP(6),
UTC_TIMESTAMP(6) + 0;
Výsledek:
+----------------------------+-----------------------+ | UTC_TIMESTAMP(6) | UTC_TIMESTAMP(6) + 0 | +----------------------------+-----------------------+ | 2021-06-01 23:00:50.105119 | 20210601230050.105119 | +----------------------------+-----------------------+
Neplatné argumenty
Předání neplatného argumentu má za následek chybu:
SELECT UTC_TIMESTAMP('Six');
Výsledek:
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