MariaDBでは、UTC_TIME()
は、現在のUTC時刻を返す組み込みの日付と時刻の関数です。
結果は、関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、「HH:MM:SS」またはHHMMSS.uuuuuu形式で返されます。
UTCは協定世界時の略で、時間を規制するための世界標準です。
構文
UTC_TIME()
次の2つの方法で呼び出すことができます:
UTC_TIME
UTC_TIME([precision])
ここでprecision
使用するマイクロ秒の精度を指定するオプションの引数です。
例
次に例を示します:
SELECT
UTC_TIME,
UTC_TIME();
結果:
+----------+------------+ | UTC_TIME | UTC_TIME() | +----------+------------+ | 00:17:09 | 00:17:09 | +----------+------------+
精度
使用する精度を指定する例を次に示します。
SELECT
UTC_TIME(3),
UTC_TIME(6);
結果:
+--------------+-----------------+ | UTC_TIME(3) | UTC_TIME(6) | +--------------+-----------------+ | 00:18:21.667 | 00:18:21.667957 | +--------------+-----------------+
数値コンテキスト
数値コンテキストで使用する場合、UTC_TIME()
その値をHHMMSS.uuuuuu形式で返します:
SELECT
UTC_TIME(6),
UTC_TIME(6) + 0;
結果:
+-----------------+-----------------+ | UTC_TIME(6) | UTC_TIME(6) + 0 | +-----------------+-----------------+ | 23:01:18.921377 | 230118.921377 | +-----------------+-----------------+
無効な引数
無効な引数を渡すと、エラーが発生します:
SELECT UTC_TIME('Six');
結果:
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