본문으로 건너뛰기
최종 수정: 에

MICROSECONDS_DIFF

설명​

MICROSECONDS_DIFF 함수는 두 날짜 및 시간 값 사이의 차이를 마이크로초 단위로 계산합니다. 결과는 종료 시간과 시작 시간 사이의 간격에 해당하는 마이크로초 수입니다. 이 함수는 마이크로초 정밀도의 DATETIME 타입을 처리할 수 있습니다.

구문​

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

매개변수​

매개변수설명
<date_or_time_expr1>DATETIME 타입의 종료 시간입니다. 날짜 및 시간 형식은 날짜 및 시간 변환을 참조하세요.
<date_or_time_expr2>DATETIME 타입 또는 유효한 날짜 및 시간 문자열로 지정하는 시작 시간입니다.

반환 값​

두 시간의 차이를 마이크로초 단위로 나타내는 BIGINT 타입의 값을 반환합니다.

  • <date_or_time_expr1>이 <date_or_time_expr2>보다 크면 양수를 반환합니다.
  • <date_or_time_expr1>이 <date_or_time_expr2>보다 작으면 음수를 반환합니다.
  • 두 시간이 마이크로초 부분까지 동일하면 0을 반환합니다.
  • 매개변수 중 하나라도 NULL이면 NULL을 반환합니다.

예제​

-- Calculate the microsecond difference between two datetime values
SELECT MICROSECONDS_DIFF('2020-12-25 21:00:00.623000', '2020-12-25 21:00:00.123000');

+------------------------------------------------------------------------------+
| MICROSECONDS_DIFF('2020-12-25 21:00:00.623000','2020-12-25 21:00:00.123000') |
+------------------------------------------------------------------------------+
|                                                                       500000 |
+------------------------------------------------------------------------------+

--If the end time is earlier than the start time, a negative number is returned.
SELECT MICROSECONDS_DIFF('2023-10-01 12:00:00.500000', '2023-10-01 12:00:00.800000');
+-------------------------------------------------------------------------------+
| MICROSECONDS_DIFF('2023-10-01 12:00:00.500000', '2023-10-01 12:00:00.800000') |
+-------------------------------------------------------------------------------+
|                                                                       -300000 |
+-------------------------------------------------------------------------------+

-- Input type is date, time part defaults to 00:00:00.000000
SELECT MICROSECONDS_DIFF('2023-10-01 12:00:00.500000', '2023-10-01');
+---------------------------------------------------------------+
| MICROSECONDS_DIFF('2023-10-01 12:00:00.500000', '2023-10-01') |
+---------------------------------------------------------------+
|                                                   43200500000 |
+---------------------------------------------------------------+

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

--- datetime is same,return 0
 SELECT MICROSECONDS_DIFF('2025-08-11 15:30:00.123456', '2025-08-11 15:30:00.123456');
+-------------------------------------------------------------------------------+
| MICROSECONDS_DIFF('2025-08-11 15:30:00.123456', '2025-08-11 15:30:00.123456') |
+-------------------------------------------------------------------------------+
|                                                                             0 |
+-------------------------------------------------------------------------------+
Report issue