MySQL - ADDDATE() 函式

MySQL 中的 DATE、DATETIME 和 TIMESTAMP 資料型別分別用於儲存日期、日期和時間以及時間戳值。這些值被稱為時間值，因為它們是會隨精度變化而不斷變化的瞬時值（例如，臨時值）。MySQL 提供了一套函式來操作這些值。

MySQL ADDDATE() 函式

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

語法

以下是上述函式的語法：

ADDDATE(date, INTERVAL expr unit);

引數

以下是此函式接受的引數：

**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 值。

另一種語法

此函式還有 **另一種語法**，如下所示。在這裡，我們提供一個表示日期的“表示式”和“天數”作為間隔，表示要新增到給定日期的天數：

ADDDATE(expr, days);

示例

以下示例演示了 **ADDDATE()** 函式的使用：

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

輸出

獲得以下輸出：

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

示例

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

SELECT ADDDATE('2018-05-23 20:40:32.88558', '13 6:4:1.222222');

輸出

獲得以下輸出：

ADDDATE('2018-05-23 20:40:32.88558', '13 6:4:1.222222')
2018-06-05 20:40:32.885580

示例

以下示例演示了此函式的第二種語法，其中我們將要新增的天數作為間隔傳遞：

SELECT ADDDATE('1995-11-15', 554);

輸出

獲得以下輸出：

ADDDATE('1995-11-15', 554)
1997-05-22

示例

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

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

在另一個查詢中，讓我們在不使用 INTERVAL 關鍵字的情況下傳遞負間隔值：

SELECT ADDDATE('2015-09-05', -20) AS ADDDATE;

輸出

獲得以下輸出：

ADDDATE
2015-08-16

示例

以下示例演示了 ADDDATE() 函式中可用各種單位的使用。

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

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

獲得以下輸出：

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

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

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

獲得以下輸出：

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

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

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

獲得以下輸出：

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

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

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

獲得以下輸出：

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

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

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

獲得以下輸出：

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

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

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

獲得以下輸出：

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

示例

在此示例中，我們使用以下 CREATE TABLE 查詢建立了一個名為 **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, ADDDATE(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

示例

我們也可以新增一個時間間隔而無需指定INTERVAL關鍵字。在這個例子中，下面的查詢將225天新增到DATE列的值中：

SELECT OID, DATE, ADDDATE(DATE, 225), AMOUNT FROM ORDERS;

輸出

輸出顯示如下：

OID	DATE	ADDDATE(DATE, 255)	AMOUNT
102	2009-10-08 00:00:00	2010-05-21 00:00:00	3000.00
100	2009-10-08 00:00:00	2010-05-21 00:00:00	1500.00
101	2009-11-20 00:00:00	2010-07-03 00:00:00	1560.00
103	2008-05-20 00:00:00	2008-12-31 00:00:00	2060.00

列印頁面