在本教程中,您将学习如何使用MySQL DATE_ADD
函数将时间值添加到DATE
或DATETIME
值。
MySQL DATE_ADD函数简介
DATE_ADD
函数将间隔时间添加到DATE或DATETIME值。 下面说明了DATE_ADD
函数的语法:
DATE_ADD(start_date, INTERVAL expr unit);
DATE_ADD
函数有两个参数:
start_date
是DATE
或DATETIME
的起始值。INTERVAL expr unit
是要添加到起始日期值的间隔值。
根据参数,DATE_ADD
函数可能会返回一个DATETIME
值或一个字符串:
DATETIME
- 如果第一个参数是DATETIME
值,或者如果间隔值具有时间元素,如小时,分钟或秒等。- 否则返回字符串。
MySQL DATE_ADD函数示例
我们来看几个例子来了解DATE_ADD
函数的工作原理。
示例-1 加1
秒到时间:2017-12-31 23:59:59
:
mysql> SELECT DATE_ADD('2017-12-31 23:59:59', INTERVAL 1 SECOND) result;
+---------------------+
| result |
+---------------------+
| 2018-01-01 00:00:00 |
+---------------------+
1 row in set
示例-2 - 添加1
天到时间:2017-12-31 00:00:01
:
mysql> SELECT DATE_ADD('2017-12-31 00:00:01',INTERVAL 1 DAY) result;
+---------------------+
| result |
+---------------------+
| 2018-01-01 00:00:01 |
+---------------------+
1 row in set
示例-3 - 在时间2017-12-31 23:59:59
上加1
分1
秒。
mysql> SELECT DATE_ADD('2017-12-31 23:59:59', INTERVAL '1:1' MINUTE_SECOND) result;
+---------------------+
| result |
+---------------------+
| 2018-01-01 00:01:00 |
+---------------------+
1 row in set
示例-4 - 在时间2000-01-01 00:00:00
上加-1
天5
小时。
mysql> SELECT DATE_ADD('2000-01-01 00:00:00', INTERVAL '-1 5' DAY_HOUR) result;
+---------------------+
| result |
+---------------------+
| 1999-12-30 19:00:00 |
+---------------------+
1 row in set
示例-5 - 添加1
秒和999999
微秒到时间:2017-12-31 23:59:59.000002
:
mysql> SELECT DATE_ADD('2017-12-31 23:59:59.000002',INTERVAL '1.999999' SECOND_MICROSECOND) result;
+----------------------------+
| result |
+----------------------------+
| 2018-01-01 00:00:01.000001 |
+----------------------------+
1 row in set
MySQL DATE_ADD函数使用说明
间隔处理
在间隔期间 -
INTERVAL expr unit
expr
被视为一个字符串,因此,当为expr
使用非字符串值时,您应该小心。 例如,间隔为HOUR_MINUTE
,5/2
求值结果为2.5000
(不是2.5
),并被视为2
小时5000
分钟,如下面的语句所示:
mysql> SELECT DATE_ADD('2017-01-01', INTERVAL 5 / 2 HOUR_MINUTE) result;
+---------------------+
| result |
+---------------------+
| 2017-01-04 13:20:00 |
+---------------------+
1 row in set
为了确保非串间隔值的正确解释,您应该使用CAST
函数,如下所示:
mysql> SELECT DATE_ADD('2017-01-01', INTERVAL CAST(6/4 AS DECIMAL(3,1)) HOUR_MINUTE) result;
+---------------------+
| result |
+---------------------+
| 2017-01-01 01:05:00 |
+---------------------+
1 row in set
自动DATETIME转换
如果您将时间值添加到日期值,则结果为DATETIME值,如以下示例所示:
mysql> SELECT DATE_ADD('2017-01-01', INTERVAL 12 HOUR) result;
+---------------------+
| result |
+---------------------+
| 2017-01-01 12:00:00 |
+---------------------+
1 row in set
起始日期无效
如果对第一个参数使用无效的日期,DATE_ADD
函数将返回NULL
,例如:
mysql> SELECT DATE_ADD('2017-02-30', INTERVAL 1 DAY) result;
+--------+
| result |
+--------+
| NULL |
+--------+
1 row in set
如果要详细看到警告,请使用SHOW WARNINGS
语句:
mysql> SHOW WARNINGS;
+---------+------+----------------------------------------+
| Level | Code | Message |
+---------+------+----------------------------------------+
| Warning | 1292 | Incorrect datetime value: '2017-02-30' |
+---------+------+----------------------------------------+
1 row in set
调整日,月或年
如果您将MONTH
,YEAR
或YEAR_MONTH
的间隔添加到导致日期大于新月份的最大日期的日期,则该日期将被调整为新月份的最大日期。
请看看以下示例:
mysql> SELECT DATE_ADD('2017-01-30', INTERVAL 1 MONTH) result;
+------------+
| result |
+------------+
| 2017-02-28 |
+------------+
1 row in set
在这个例子中,我们在2017年1月30日相加上了1个月,结果是2017年2月28日。这一天被调整到2017年2月的最大天数。
如果是2
月份有29
天,日期也将调整为第29
天,如下所示:
mysql> SELECT DATE_ADD('2012-01-30', INTERVAL 1 MONTH) result;
+------------+
| result |
+------------+
| 2012-02-29 |
+------------+
1 row in set
在本教程中,您已经学习了如何使用MySQL DATE_ADD
函数将间隔添加到DATE
或DATETIME
值。