MILLISECONDS_ADD

설명

MILLISECONDS_ADD 함수는 입력 datetime 값에 지정된 밀리초 수를 더하고 계산된 새 datetime 값을 반환합니다. 이 함수는 밀리초 정밀도의 DATETIME 타입을 처리할 수 있습니다.

구문

MILLISECONDS_ADD(`<datetime>`, `<delta>`)

매개변수

매개변수	설명
<datetime>	입력 datetime 값입니다. DATETIME 타입을 지원합니다. 구체적인 datetime 형식은 datetime 변환을 참조하세요.
<delta>	더할 밀리초 수이며, 타입은 BIGINT입니다. 1초 = 1,000밀리초 = 1,000,000마이크로초입니다.

반환값

기준 시간에 지정된 밀리초 수를 더한 결과를 나타내는 DATETIME 타입의 값을 반환합니다.

• <delta>가 음수이면 기준 시간에서 해당 밀리초 수를 빼는 것과 동일하게 동작합니다(즉, MILLISECONDS_ADD(basetime, -n)은 MILLISECONDS_SUB(basetime, n)과 동일합니다).
• 입력이 DATE 타입이면(연도, 월, 일만 포함) 기본 시간 부분은 00:00:00.000으로 설정됩니다.
• 계산 결과가 DATETIME 타입의 유효 범위(0000-01-01 00:00:00부터 9999-12-31 23:59:59.999999까지)를 벗어나면 예외가 발생합니다.
• 매개변수 중 하나라도 NULL이면 함수는 NULL을 반환합니다.

예제

-- Add one millisecond
SELECT MILLISECONDS_ADD('2023-09-08 16:02:08.435123', 1);

+---------------------------------------------------+
| MILLISECONDS_ADD('2023-09-08 16:02:08.435123', 1) |
+---------------------------------------------------+
| 2023-09-08 16:02:08.436123                        |
+---------------------------------------------------+

-- Negative milliseconds, subtracts the corresponding milliseconds from the datetime
SELECT MILLISECONDS_ADD('2023-05-01 10:00:00.800', -300);
+---------------------------------------------------+
| MILLISECONDS_ADD('2023-05-01 10:00:00.800', -300) |
+---------------------------------------------------+
| 2023-05-01 10:00:00.500000                        |
+---------------------------------------------------+

-- Input is of DATE type (default time is 00:00:00.000)
SELECT MILLISECONDS_ADD('2023-01-01', 1500);
+--------------------------------------+
| MILLISECONDS_ADD('2023-01-01', 1500) |
+--------------------------------------+
| 2023-01-01 00:00:01.500000           |
+--------------------------------------+

-- Calculation result exceeds the datetime range, throws an exception
SELECT MILLISECONDS_ADD('9999-12-31 23:59:59.999', 2000) AS after_add;
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation milliseconds_add of 9999-12-31 23:59:59.999000, 2000 out of range

-- Any parameter is NULL, returns NULL
SELECT MILLISECONDS_ADD('2023-10-01 12:00:00.500', NULL) AS after_add;
+-----------+
| after_add |
+-----------+
| NULL      |
+-----------+

-- delta supports the full BIGINT range; values beyond INT max (2^31 - 1) still compute correctly
SELECT MILLISECONDS_ADD('2023-09-08 16:02:08.435', 2147483648) AS after_add;
+----------------------------+
| after_add                  |
+----------------------------+
| 2023-10-03 12:33:32.083000 |
+----------------------------+