UTC_TIMESTAMP

説明

UTC_TIMESTAMP関数は、UTCタイムゾーンでの現在の日付と時刻を返します。この関数はローカルタイムゾーンの影響を受けず、常にUTCタイムゾーンに基づいて現在時刻を返すため、異なるタイムゾーンシナリオ間での時刻の一貫性を保証します。

この関数は、MySQLのutc_timestamp functionと一貫した動作をします。

構文

UTC_TIMESTAMP([`<precision>`])

パラメータ

Parameter	デスクリプション
<precision>	返される日時値の精度は、[0, 6]の範囲内の整数型をサポートします。整数型の定数のみが受け入れられます。

Return Value

現在のUTC日時を返します。

DATETIME型を返します（形式：YYYY-MM-DD HH:mm

.ssssss

）。数値演算で返された結果を使用する場合、integer format（形式YYYYMMDDHHmmss）に変換されます。

入力がNULLまたは精度が範囲外の場合、エラーがスローされます。

Examples

-- Current local time is UTC+8 2025-10-27 14:43:21
SELECT UTC_TIMESTAMP(), UTC_TIMESTAMP() + 0, UTC_TIMESTAMP(5), UTC_TIMESTAMP(5) + 0;

+---------------------+---------------------+---------------------------+----------------------+
| UTC_TIMESTAMP()     | UTC_TIMESTAMP() + 0 | UTC_TIMESTAMP(5)          | UTC_TIMESTAMP(5) + 0 |
+---------------------+---------------------+---------------------------+----------------------+
| 2025-10-27 06:43:21 |      20251027064321 | 2025-10-27 06:43:21.88177 |       20251027064321 |
+---------------------+---------------------+---------------------------+----------------------+

SELECT UTC_TIMESTAMP(7);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = scale must be between 0 and 6

SELECT UTC_TIMESTAMP(NULL);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = UTC_TIMESTAMP argument cannot be NULL.