DATEDIFF

설명

DATEDIFF 함수는 두 DATE, DATETIME 또는 TIMESTAMP_NS 값의 차이를 일 단위로 계산합니다. expr2를 expr1에서 빼서 얻은 일수를 반환합니다. 이 함수는 날짜 부분만 사용하며 시간 부분의 시, 분, 초 및 소수 초는 무시합니다.

이 함수는 MySQL의 datediff 함수와 동일하게 동작합니다.

구문

DATEDIFF(<expr1>, <expr2>)

매개변수

매개변수	설명
<expr1>	피감수에 해당하는 날짜입니다. DATE, DATETIME, TIMESTAMP_NS를 지원합니다. 구체적인 형식은 datetime 변환 및 date 변환을 참조하세요.
<expr2>	감수에 해당하는 날짜입니다. DATE, DATETIME, TIMESTAMP_NS를 지원합니다.

반환값

expr1 - expr2 값을 일 단위로 반환하며, 반환 타입은 INT입니다.

특수한 경우:

• expr1이 expr2보다 크면 양수를 반환하고, 그렇지 않으면 음수를 반환합니다.
• 매개변수 중 하나라도 NULL이면 NULL을 반환합니다.
• 시간 부분은 무시합니다.

예제

-- The two dates differ by 1 day (ignoring the time part)
select datediff(CAST('2007-12-31 23:59:59' AS DATETIME), CAST('2007-12-30' AS DATETIME));
+-----------------------------------------------------------------------------------+
| datediff(CAST('2007-12-31 23:59:59' AS DATETIME), CAST('2007-12-30' AS DATETIME)) |
+-----------------------------------------------------------------------------------+
|                                                                                 1 |
+-----------------------------------------------------------------------------------+

-- The first date is earlier than the second date, returning a negative number
select datediff(CAST('2010-11-30 23:59:59' AS DATETIME), CAST('2010-12-31' AS DATETIME));
+-----------------------------------------------------------------------------------+
| datediff(CAST('2010-11-30 23:59:59' AS DATETIME), CAST('2010-12-31' AS DATETIME)) |
+-----------------------------------------------------------------------------------+
|                                                                               -31 |
+-----------------------------------------------------------------------------------+

-- TIMESTAMP_NS can be used for either parameter
SELECT DATEDIFF(CAST('2024-01-02 00:00:00.000000001' AS TIMESTAMP_NS),
                CAST('2024-01-01 23:59:59.999999' AS DATETIME(6))) AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

-- Any parameter is NULL
mysql> select datediff('2023-01-01', NULL);
+------------------------------+
| datediff('2023-01-01', NULL) |
+------------------------------+
|                         NULL |
+------------------------------+

-- If input datetime type, will ignore time part
select datediff('2023-01-02 13:00:00', '2023-01-01 12:00:00');
+--------------------------------------------------------+
| datediff('2023-01-02 13:00:00', '2023-01-01 12:00:00') |
+--------------------------------------------------------+
|                                                      1 |
+--------------------------------------------------------+

select datediff('2023-01-02 12:00:00', '2023-01-01 13:00:00');
+--------------------------------------------------------+
| datediff('2023-01-02 12:00:00', '2023-01-01 13:00:00') |
+--------------------------------------------------------+
|                                                      1 |
+--------------------------------------------------------+
1 row in set (0.01 sec)