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

打印页面