UTC_TIMESTAMP

描述

UTC_TIMESTAMP 函数用于返回当前 UTC 时区在所的日期时间。该函数不受本地时区影响，始终返回基于 UTC 时区的当前时间，确保跨时区场景下的时间一致性.

该函数与 mysql 中的 utc_timestamp 函数 行为一致。

语法

UTC_TIMESTAMP([`<precision>`])

参数

参数	描述
<precision>	返回的时间值的精度，支持[0, 6]范围内的整数类型。仅接受整数类型常量。

返回值

返回当前 UTC 日期时间.

返回 DATETIME 类型（格式：YYYY-MM-DD HH:mm

.ssssss

）。当使用返回结果进行数值运算时，会进行类型转换，返回整数格式（格式YYYYMMDDHHmmss）。

当输入为 NULL 或精度超出范围会报错。

举例

---当前地区时间为东八区 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.