MILLISECONDS_SUB

설명

MILLISECONDS_SUB 함수는 DATETIME, TIMESTAMP_NS 또는 TIMESTAMPTZ 값에서 지정한 밀리초 수를 빼고 동일한 타입의 결과 값을 반환합니다.

구문

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

매개변수

매개변수	설명
<datetime>	입력 날짜 및 시간 값으로, 타입은 DATETIME, TIMESTAMP_NS 또는 TIMESTAMPTZ입니다. 구체적인 형식은 날짜 및 시간 변환, TIMESTAMP_NS 변환, TIMESTAMPTZ 변환을 참조하세요.
<delta>	뺄 밀리초 수로, 타입은 BIGINT입니다. 1초 = 1,000밀리초 = 1,000,000마이크로초입니다.

반환 값

TIMESTAMP_NS 타입을 입력하면 초의 소수부 정밀도가 아홉 자리로 고정된 TIMESTAMP_NS를 반환합니다. 결과는 반환 타입의 유효 범위에 따라 검증되며, TIMESTAMP_NS의 범위는 [1677-09-21 00:12:43.145224192, 2262-04-11 23:47:16.854775807]입니다.

입력과 동일한 시간 타입을 반환하며, 반환 값은 기준 시간에서 지정한 밀리초를 뺀 결과를 나타냅니다.

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

예제

-- Subtract 1 millisecond
SELECT MILLISECONDS_SUB('2023-09-08 16:02:08.435123', 1);
+---------------------------------------------------+
| MILLISECONDS_SUB('2023-09-08 16:02:08.435123', 1) |
+---------------------------------------------------+
| 2023-09-08 16:02:08.434123                        |
+---------------------------------------------------+

-- Negative delta (equivalent to addition)
SELECT MILLISECONDS_SUB('2023-05-01 10:00:00.200', -300);
+---------------------------------------------------+
| MILLISECONDS_SUB('2023-05-01 10:00:00.200', -300) |
+---------------------------------------------------+
| 2023-05-01 10:00:00.500000                        |
+---------------------------------------------------+

-- Input is of DATE type (default time is 00:00:00.000)
SELECT MILLISECONDS_SUB('2023-01-01', 1500);
+--------------------------------------+
| MILLISECONDS_SUB('2023-01-01', 1500) |
+--------------------------------------+
| 2022-12-31 23:59:58.500000           |
+--------------------------------------+

-- Calculation result exceeds the datetime range, throws an exception
SELECT MILLISECONDS_SUB('0000-01-01',-1500);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation milliseconds_add of 0000-01-01 00:00:00, -1500 out of range

-- Any parameter is NULL, returns NULL
SELECT MILLISECONDS_SUB(NULL, 100), MILLISECONDS_SUB('2023-01-01', NULL) AS after_sub;
+------------------------------+----------------------------+
| milliseconds_sub(NULL, 100)  | after_sub                  |
+------------------------------+----------------------------+
| NULL                         | NULL                       |
+------------------------------+----------------------------+