MILLISECONDS_DIFF

설명

MILLISECONDS_DIFF 함수는 두 날짜 및 시간 값의 차이를 밀리초 단위로 계산합니다. 결과는 종료 시간에서 시작 시간을 뺀 밀리초 수입니다. 이 함수는 DATETIME과 TIMESTAMP_NS를 지원합니다.

구문

MILLISECONDS_DIFF(`<date_or_time_expr1>`, `<date_or_time_expr2>`)

매개변수

매개변수	설명
<date_or_time_expr1>	종료 시간입니다. 타입은 DATETIME 또는 TIMESTAMP_NS입니다.
<date_or_time_expr2>	시작 시간입니다. 타입은 DATETIME 또는 TIMESTAMP_NS입니다.

반환 값

INT 타입의 값을 반환하며, 이 값은 두 시간의 차이를 밀리초 단위로 나타냅니다.

• <date_or_time_expr1>이 <date_or_time_expr2>보다 늦으면 결과는 양수입니다.
• <date_or_time_expr1>이 <date_or_time_expr2>보다 이르면 결과는 음수입니다.
• 두 시간이 밀리초 부분까지 동일하면 결과는 0입니다.
• 입력이 DATE 타입인 경우(연, 월, 일만 포함), 시간 부분은 기본값인 00:00:00.000으로 설정됩니다.
• 입력 시간에 마이크로초가 포함된 경우(예: '2023-01-01 00:00:00.123456'), 계산 시 자동으로 밀리초 정밀도까지만 남기고 나머지는 잘라냅니다(예: 123 milliseconds).
• 매개변수 중 하나라도 NULL이면 함수는 NULL을 반환합니다.

예제

-- Calculate millisecond difference
SELECT MILLISECONDS_DIFF('2020-12-25 21:00:00.623000', '2020-12-25 21:00:00.123000');
+-------------------------------------------------------------------------------+
| MILLISECONDS_DIFF('2020-12-25 21:00:00.623000', '2020-12-25 21:00:00.123000') |
+-------------------------------------------------------------------------------+
|                                                                           500 |
+-------------------------------------------------------------------------------+

-- End time is earlier than start time, returns negative value
SELECT MILLISECONDS_DIFF('2023-10-01 12:00:00.500', '2023-10-01 12:00:00.800');
+-------------------------------------------------------------------------+
| MILLISECONDS_DIFF('2023-10-01 12:00:00.500', '2023-10-01 12:00:00.800') |
+-------------------------------------------------------------------------+
|                                                                    -300 |
+-------------------------------------------------------------------------+

-- Input includes microseconds (automatically truncated to milliseconds)
SELECT MILLISECONDS_DIFF('2023-01-01 00:00:00.123456', '2023-01-01 00:00:00.000123');
+-------------------------------------------------------------------------------+
| MILLISECONDS_DIFF('2023-01-01 00:00:00.123456', '2023-01-01 00:00:00.000123') |
+-------------------------------------------------------------------------------+
|                                                                           123 |
+-------------------------------------------------------------------------------+

-- Input is of DATE type (default time is 00:00:00.000)
SELECT MILLISECONDS_DIFF('2023-10-02', '2023-10-01');
+-----------------------------------------------+
| MILLISECONDS_DIFF('2023-10-02', '2023-10-01') |
+-----------------------------------------------+
|                                      86400000 |
+-----------------------------------------------+

-- Any parameter is NULL, returns NULL
SELECT MILLISECONDS_DIFF('2023-01-01 00:00:00', NULL), MILLISECONDS_DIFF(NULL, '2023-01-01 00:00:00');
+------------------------------------------------+------------------------------------------------+
| milliseconds_diff('2023-01-01 00:00:00', NULL) | milliseconds_diff(NULL, '2023-01-01 00:00:00') |
+------------------------------------------------+------------------------------------------------+
| NULL                                           | NULL                                           |
+------------------------------------------------+------------------------------------------------+

-- Times are identical, returns 0
SELECT MILLISECONDS_DIFF('2025-08-11 15:30:00.123', '2025-08-11 15:30:00.123');
+-------------------------------------------------------------------------+
| MILLISECONDS_DIFF('2025-08-11 15:30:00.123', '2025-08-11 15:30:00.123') |
+-------------------------------------------------------------------------+
|                                                                       0 |
+-------------------------------------------------------------------------+