跳到主要内容
版本: 最新版本-3.5

date_add,adddate

将指定的时间间隔添加到日期。

语法

DATETIME DATE_ADD(DATETIME|DATE date,INTERVAL expr type)

参数

  • date:必须是有效的日期或日期时间表达式。
  • expr:要添加的时间间隔。它必须是INT类型。
  • type:时间间隔的单位。 它只能设置为以下值中的任何一个:YEAR、QUARTER、MONTH、DAY、HOUR、MINUTE、SECOND、MILLISECOND(自 3.1.7 起)和 MICROSECOND(自 3.1.7 起)。

返回值

返回 DATETIME 值。如果日期不存在,例如 2020-02-30,则返回 NULL。 如果日期是 DATE 值,它将被转换为 DATETIME 值。

示例

select date_add('2010-11-30 23:59:59', INTERVAL 2 DAY);
+-------------------------------------------------+
| date_add('2010-11-30 23:59:59', INTERVAL 2 DAY) |
+-------------------------------------------------+
| 2010-12-02 23:59:59 |
+-------------------------------------------------+

select date_add('2010-12-03', INTERVAL 2 DAY);
+----------------------------------------+
| date_add('2010-12-03', INTERVAL 2 DAY) |
+----------------------------------------+
| 2010-12-05 00:00:00 |
+----------------------------------------+

select date_add('2010-11-30 23:59:59', INTERVAL 2 QUARTER);
+-----------------------------------------------------+
| date_add('2010-11-30 23:59:59', INTERVAL 2 QUARTER) |
+-----------------------------------------------------+
| 2011-05-30 23:59:59 |
+-----------------------------------------------------+

select adddate('2023-10-31 23:59:59', INTERVAL 1 MILLISECOND);
+--------------------------------------------------------+
| adddate('2023-10-31 23:59:59', INTERVAL 1 MILLISECOND) |
+--------------------------------------------------------+
| 2023-10-31 23:59:59.001000 |
+--------------------------------------------------------+

select adddate('2023-10-31 23:59:59', INTERVAL 1 MICROSECOND);
+--------------------------------------------------------+
| adddate('2023-10-31 23:59:59', INTERVAL 1 MICROSECOND) |
+--------------------------------------------------------+
| 2023-10-31 23:59:59.000001 |
+--------------------------------------------------------+