MICROSECONDS_SUB

설명

MICROSECONDS_SUB 함수는 입력 datetime 값에서 지정된 마이크로초 수를 빼고 계산된 새 datetime 값을 반환합니다. 이 함수는 마이크로초 정밀도의 DATETIME 및 TIMESTAMPTZ 타입 처리를 지원합니다.

이 함수는 MICROSECOND를 단위로 사용할 때 MySQL의 date_sub 함수와 동일하게 동작합니다.

구문

MICROSECONDS_SUB(`<datetime_like_type>`, `<delta>`)

매개변수

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

반환 값

지정된 마이크로초 수 <delta>를 기준 시간 <datetime_like_type>에서 뺀 결과를 반환합니다. 반환 타입은 첫 번째 매개변수의 타입과 같습니다.

• <delta>가 음수이면 기준 시간에 해당 마이크로초 수를 더하는 것과 동일하게 동작합니다. 즉, MICROSECONDS_SUB(basetime, -n)은 MICROSECONDS_ADD(basetime, n)과 같습니다.
• 계산 결과가 DATETIME 타입의 유효 범위(0000-01-01 00:00:00부터 9999-12-31 23:59:59.999999까지)를 벗어나면 예외가 발생합니다.
• 매개변수 중 하나라도 NULL이면 함수는 NULL을 반환합니다.

예제

-- Subtract microseconds
SELECT NOW(3) AS current_time, MICROSECONDS_SUB(NOW(3), 100000) AS after_sub;

+-------------------------+----------------------------+
| current_time            | after_sub                  |
+-------------------------+----------------------------+
| 2025-01-16 11:52:22.296 | 2025-01-16 11:52:22.196000 |
+-------------------------+----------------------------+

-- Negative delta (equivalent to addition)
mysql> SELECT MICROSECONDS_SUB('2023-10-01 12:00:00.200000', -300000) AS after_sub;
+----------------------------+
| after_sub                  |
+----------------------------+
| 2023-10-01 12:00:00.500000 |
+----------------------------+

-- Any parameter is NULL, returns NULL
SELECT MICROSECONDS_SUB(NULL, 1000), MICROSECONDS_SUB('2023-01-01', NULL) AS after_sub;
+------------------------------+----------------------------+
| microseconds_sub(NULL, 1000) | after_sub                  |
+------------------------------+----------------------------+
| NULL                         | NULL                       |
+------------------------------+----------------------------+

-- Input type is DATE, time part is automatically set to 00:00:00.000000
SELECT MICROSECONDS_SUB('2023-10-01', -300000);
+-----------------------------------------+
| MICROSECONDS_SUB('2023-10-01', -300000) |
+-----------------------------------------+
| 2023-10-01 00:00:00.300000              |
+-----------------------------------------+

-- Example of TimeStampTz type, SET time_zone = '+08:00'
SELECT MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800');
+-------------------------------------------------------------+
| MICROSECONDS_SUB('2024-12-25 12:34:56.123+04:00', '765800') |
+-------------------------------------------------------------+
| 2024-12-25 16:34:55.357200+08:00                            |
+-------------------------------------------------------------+

-- Exceeds datetime range, throws an error
mysql> SELECT MICROSECONDS_SUB('0000-01-01 00:00:00.000000', 1000000) AS after_sub;
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation microseconds_add of 0000-01-01 00:00:00, -1000000 
out of range