UTC_TIME
説明
UTC_TIME関数は、UTCタイムゾーンでの現在時刻を返します。この関数はローカルタイムゾーンの影響を受けず、常にUTCタイムゾーンに基づいた現在時刻を返すため、異なるタイムゾーンのシナリオ間で時刻の一貫性を保証します。
この関数は、MySQLのutc_time functionと一貫した動作をします。
構文
UTC_TIME([<`precision`>])
パラメータ
| パラメータ | 説明 |
|---|---|
<precision> | 戻り値の時刻の精度は[0, 6]の範囲内の整数型をサポートします。整数型の定数のみが受け入れられます。 |
戻り値
現在のUTC時刻を返します。
Time型を返します（形式：HH:mm:ss）。戻り値を数値演算で使用する場合、整数形式に変換されます（00:00:00からの経過時間値、単位はマイクロ秒）。
入力がNULLまたは精度が範囲外の場合、エラーが発生します。
例
-- Assume the current local time is UTC+8 2025-10-27 14:39:01
SELECT UTC_TIME(), UTC_TIME() + 1, UTC_TIME(6), UTC_TIME(6) + 1;
------------+----------------+-----------------+-----------------+
| UTC_TIME() | UTC_TIME() + 1 | UTC_TIME(6) | UTC_TIME(6) + 1 |
+------------+----------------+-----------------+-----------------+
| 06:39:01 | 23941000001 | 06:39:01.934119 | 23941934120 |
+------------+----------------+-----------------+-----------------+
SELECT UTC_TIME(7);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = scale must be between 0 and 6
SELECT UTC_TIME(NULL);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = UTC_TIME argument cannot be NULL.