UTC_TIMESTAMP

설명

UTC_TIMESTAMP 함수는 UTC 시간대의 현재 날짜와 시간을 반환합니다. 이 함수는 로컬 시간대의 영향을 받지 않으며 항상 UTC 시간대를 기준으로 현재 시간을 반환하므로, 서로 다른 시간대에서도 시간의 일관성을 보장합니다.

이 함수는 MySQL의 utc_timestamp 함수와 동일하게 동작합니다.

구문

UTC_TIMESTAMP([`<precision>`])

매개변수

매개변수	설명
<precision>	[0, 9] 범위의 선택적 정수 상수입니다. 기본값은 0입니다.

반환값

현재 UTC 날짜와 시간을 반환합니다.

정밀도가 0에서 6이면 DATETIME(<precision>)을 반환합니다. 정밀도가 7에서 9이면 TIMESTAMP_NS를 반환하며, 소수점 이하 아홉 자리까지 표시됩니다. 반환된 결과를 숫자 연산에 사용하면 정수 형식(YYYYMMDDHHmmss 형식)으로 변환됩니다. 값은 하나의 문 내에서 일정하게 유지됩니다.

입력값이 NULL이거나 정밀도가 범위를 벗어나면 오류가 발생합니다.

예제

-- 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(10);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = Precision of UTC_TIMESTAMP must be between 0 and 9. Precision was set to: 10

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