MariaDBでのUTC_TIMESTAMP（）のしくみ

MariaDBでは、UTC_TIMESTAMP() は、現在のUTC日時を返す組み込みの日付と時刻の関数です。

結果は、関数が文字列または数値のどちらのコンテキストで使用されているかに応じて、「YYYY-MM-DD HH：MM：SS」またはYYYYMMDDHHMMSS.uuuuuu形式で返されます。

UTCは協定世界時の略で、時間を規制するための世界標準です。

構文

UTC_TIMESTAMP() 次の2つの方法で呼び出すことができます：

UTC_TIMESTAMP
UTC_TIMESTAMP([precision])

ここでprecision 使用するマイクロ秒の精度を指定するオプションの引数です。

例

次に例を示します：

SELECT 
    UTC_TIMESTAMP,
    UTC_TIMESTAMP();

結果：

+---------------------+---------------------+
| UTC_TIMESTAMP       | UTC_TIMESTAMP()     |
+---------------------+---------------------+
| 2021-06-01 22:54:53 | 2021-06-01 22:54:53 |
+---------------------+---------------------+

精度

使用する精度を指定する例を次に示します。

SELECT 
    UTC_TIMESTAMP(3),
    UTC_TIMESTAMP(6);

結果：

+-------------------------+----------------------------+
| UTC_TIMESTAMP(3)        | UTC_TIMESTAMP(6)           |
+-------------------------+----------------------------+
| 2021-06-01 22:55:09.880 | 2021-06-01 22:55:09.880201 |
+-------------------------+----------------------------+

数値コンテキスト

数値コンテキストで使用する場合、UTC_TIMESTAMP() その値をYYYYMMDDHHMMSS.uuuuuu形式で返します：

SELECT 
    UTC_TIMESTAMP(6),
    UTC_TIMESTAMP(6) + 0;

結果：

+----------------------------+-----------------------+
| UTC_TIMESTAMP(6)           | UTC_TIMESTAMP(6) + 0  |
+----------------------------+-----------------------+
| 2021-06-01 23:00:50.105119 | 20210601230050.105119 |
+----------------------------+-----------------------+

無効な引数

無効な引数を渡すと、エラーが発生します：

SELECT UTC_TIMESTAMP('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