UTC_TIME

Описание

Функция UTC_TIME возвращает текущее время в часовом поясе UTC. Эта функция не зависит от локального часового пояса и всегда возвращает текущее время в часовом поясе UTC, обеспечивая согласованность времени при работе с разными часовыми поясами.

Поведение этой функции соответствует поведению функции utc_time в MySQL.

Синтаксис

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.