Skip to main content
Version: Latest-3.2

date_add,adddate

Description​

Adds a specified time interval to a date.

Syntax​

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

Parameters​

  • date: It must be a valid date or datetime expression.
  • expr: the time interval you want to add. It must be of the INT type.
  • type: the unit of the time interval. It can only be set to any of the following values: YEAR, QUARTER, MONTH, DAY, HOUR, MINUTE, SECOND, MILLISECOND (since 3.1.7), and MICROSECOND (since 3.1.7).

Return value​

Returns a DATETIME value. If the date does not exist, for example, 2020-02-30, NULL is returned. If the date is a DATE value, it will be converted into a DATETIME value.

Examples​

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                             |
+--------------------------------------------------------+