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

打印页面