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。
返回值
此函数返回在原始日期上加上指定间隔后的新日期或日期时间值。
其他语法
此函数有其他语法,如下所示。在这里,我们提供了一个表示日期的"表达式",并使用"days"作为间隔,表示要添加到给定日期的天数 -
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() 函数中各种可用单位的用法。
在以下查询中,我们将 YEAR_MONTH 单位与 INTERVAL 表达式结合使用 -
SELECT ADDDATE('2021-03-22', INTERVAL '5-6' YEAR_MONTH );
获得以下输出 -
ADDDATE('2021-03-22', INTERVAL '5-6' YEAR_MONTH ) |
---|
2026-09-22 |
我们在以下查询中使用 WEEK 单位和 INTERVAL 表达式 -
SELECT ADDDATE('2021-03-22', INTERVAL '3' WEEK );
获得以下输出 -
ADDDATE('2021-03-22', INTERVAL '3' WEEK ) |
---|
2021-04-12 |
我们在以下查询中使用 QUARTER 单位和 INTERVAL 表达式 -
SELECT ADDDATE('2021-03-22', INTERVAL '3' QUARTER );
获得以下输出 -
ADDDATE('2021-03-22', INTERVAL '3' QUARTER ) |
---|
2021-12-22 |
我们在以下查询中使用 MINUTE_MICROSECOND 单位和 INTERVAL 表达式 -
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 |
我们在以下查询中使用 SECOND_MICROSECOND 单位和 INTERVAL 表达式 -
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 |
我们在以下查询中使用 MINUTE_SECOND 单位和 INTERVAL 表达式 -
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, INTERVAL 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 |