MySQL - DATE_ADD() 函式

MySQL 的 DATE_ADD() 函式是 MySQL ADDDATE() 函式的同義詞。

DATE_ADD() 函式也用於將指定的間隔新增到日期值。此函式接受兩個引數：一個是日期，另一個是需要新增到指定日期值的間隔。得到的結果將是新增間隔後的最終日期。如果日期和間隔引數都為 NULL，則返回 NULL 值。

它在需要時間間隔的場景中非常有用。

語法

以下是上述函式的語法：

DATE_ADD(date, INTERVAL expr unit);

引數

此方法接受 3 個引數。具體描述如下：

date 表示日期的值，可以是字串型別、DATE 型別（年、月、日）、DATETIME 型別（小時、分鐘或秒）或 TIMESTAMP 型別。
expr 表示間隔值。
unit 是 expr 值表示的間隔型別，可以是 DAY、WEEK、MONTH、QUARTER、YEAR、HOUR、MINUTE、SECOND、MICROSECOND。

unit 引數可以混合使用以下值：SECOND_MICROSECOND、MINUTE_MICROSECOND、MINUTE_SECOND、HOUR_MICROSECOND、HOUR_SECOND、HOUR_MINUTE、DAY_MICROSECOND、DAY_SECOND、DAY_MINUTE、DAY_HOUR、YEAR_MONTH。

返回值

此函式返回一個新的日期或 datetime 值，該值是將指定的時間間隔新增到輸入日期的結果。

示例

以下示例演示了 DATE_ADD() 函式的用法：

SELECT DATE_ADD('2015-09-05', INTERVAL 20 DAY);

輸出

得到以下輸出：

DATE_ADD('2015-09-05', INTERVAL 20 DAY)
2015-09-25

示例

在以下示例中，我們為日期傳遞 DATETIME 值：

SELECT DATE_ADD('2018-05-23 20:40:32.88558', INTERVAL 3 WEEK);

輸出

得到以下輸出：

DATE_ADD('2018-05-23 20:40:32.88558', INTERVAL 3 WEEK)
2018-06-05 20:40:32.885580

示例

我們還可以將負值作為引數傳遞給此函式：

SELECT DATE_ADD('2015-09-05', INTERVAL -20 DAY);

輸出

得到以下輸出：

DATE_ADD('2015-09-05', INTERVAL -20 DAY)
2015-08-16

示例

以下示例演示了 DATE_ADD() 函式中可用各種單位的用法：

我們在以下查詢中使用 YEAR_MONTH 單位和 INTERVAL 表示式：

SELECT DATE_ADD('2021-03-22', INTERVAL '5-6 ' YEAR_MONTH );

得到以下輸出：

DATE_ADD('2021-03-22', INTERVAL '5-6' YEAR_MONTH )
2026-09-22

我們在以下查詢中使用 WEEK 單位和 INTERVAL 表示式：

SELECT DATE_ADD('2021-03-22', INTERVAL '3' WEEK );

得到以下輸出：

DATE_ADD('2021-03-22', INTERVAL '3' WEEK )
2021-04-12

我們在以下查詢中使用 QUARTER 單位和 INTERVAL 表示式：

SELECT DATE_ADD('2021-03-22', INTERVAL '3' QUARTER );

得到以下輸出：

DATE_ADD('2021-03-22', INTERVAL '3' QUARTER )
2021-12-22

我們在以下查詢中使用 MINUTE_MICROSECOND 單位和 INTERVAL 表示式：

SELECT DATE_ADD('2021-03-22', INTERVAL '10:09.2362191' MINUTE_MICROSECOND);

得到以下輸出：

DATE_ADD('2021-03-22', INTERVAL '10:09.2362191' MINUTE_MICROSECOND)
2021-03-22 00:10:11.362191

我們在以下查詢中使用 SECOND_MICROSECOND 單位和 INTERVAL 表示式：

SELECT DATE_ADD('2021-03-22', INTERVAL '10.2362191' SECOND_MICROSECOND);

得到以下輸出：

DATE_ADD('2021-03-22', INTERVAL '10.2362191' SECOND_MICROSECOND)
2021-03-22 00:00:12.362191

我們在以下查詢中使用 MINUTE_SECOND 單位和 INTERVAL 表示式：

SELECT DATE_ADD('2021-03-22', INTERVAL '10.21' MINUTE_SECOND);

得到以下輸出：

DATE_ADD('2021-03-22', INTERVAL '10.21' MINUTE_SECOND)
2021-03-22 00:10:21

示例

您還可以將列名作為引數傳遞給此函式。讓我們使用 CREATE TABLE 語句在 MySQL 資料庫中建立一個名為 ORDERS 的表，如下所示：

CREATE TABLE ORDERS (
   OID INT NOT NULL,
   DATE VARCHAR (20) NOT NULL,
   CUSTOMER_ID INT NOT NULL,
   AMOUNT DECIMAL (18, 2)
);

現在，使用 INSERT 語句將以下記錄插入 ORDERS 表：

INSERT INTO ORDERS VALUES 
(102, '2009-10-08 00:00:00', 3, 3000.00),
(100, '2009-10-08 00:00:00', 3, 1500.00),
(101, '2009-11-20 00:00:00', 2, 1560.00),
(103, '2008-05-20 00:00:00', 4, 2060.00);

以下查詢將 14 天的間隔新增到 DATE 列中的值：

SELECT OID, DATE, DATE_ADD(DATE, INTERVAL 14 DAY), AMOUNT 
FROM ORDERS;

輸出

輸出顯示如下：

OID	DATE	ADDDATE(DATE, INTERVAL 14 DAY)	AMOUNT
102	2009-10-08 00:00:00	2009-10-22 00:00:00	3000.00
100	2009-10-08 00:00:00	2009-10-22 00:00:00	1500.00
101	2009-11-20 00:00:00	2009-12-04 00:00:00	1560.00
103	2008-05-20 00:00:00	2008-06-03 00:00:00	2060.00

列印頁面