search
Search
Login
Math ML
Map of Data Science
Join our weekly DS/ML newsletter
menu
menu search toc more_vert
Robocat
Guest 0reps
Thanks for the thanks!
close
Comments
Log in or sign up
Cancel
Post
account_circle
Profile
exit_to_app
Sign out
help Ask a question
Share on Twitter
search
keyboard_voice
close
Searching Tips
Search for a recipe:
"Creating a table in MySQL"
Search for an API documentation: "@append"
Search for code: "!dataframe"
Apply a tag filter: "#python"
Useful Shortcuts
/ to open search panel
Esc to close search panel
to navigate between search results
d to clear all current filters
Enter to expand content preview
icon_star
Doc Search
icon_star
Code Search Beta
SORRY NOTHING FOUND!
mic
Start speaking...
Voice search is only supported in Safari and Chrome.
Navigate to
A
A
brightness_medium
share
arrow_backShare

MySQL | DATE_ADD method

Database
chevron_right
MySQL
chevron_right
Documentation
chevron_right
Functions
chevron_right
Date and Time
schedule Jul 1, 2022
Last updated
local_offer MySQL
Tags

MySQL's DATE_ADD(~) method adds the specified time interval to a date or datetime value.

Syntax

SELECT DATE_ADD(date, INTERVAL expr unit);

Parameters

1. date | date/datetime

The date / datetime to add the time interval to.

2. expr unit | integer with units

The interval to add to the provided date together with its units.

Refer to 'List of units' at the bottom of page for a valid list of units.

Return value

The result of adding the specified interval to date.

Examples

Consider the following table about some students:

student_id

fname

lname

day_enrolled

age

username

1

Sky

Towner

2015-12-03

17

stowner1

2

Ben

Davis

2016-04-20

19

bdavis2

3

Travis

Apple

2018-08-14

18

tapple3

4

Arthur

David

2016-04-01

16

adavid4

5

Benjamin

Town

2014-01-01

17

btown5

The above sample table can be created using the code here.

Basic usage

To add 2 days to student enrollment dates:

SELECT fname, day_enrolled, DATE_ADD(day_enrolled, INTERVAL 2 DAY)
FROM students;
+----------+--------------+----------------------------------------+
| fname | day_enrolled | DATE_ADD(day_enrolled, INTERVAL 2 DAY) |
+----------+--------------+----------------------------------------+
| Sky | 2015-12-03 | 2015-12-05 |
| Ben | 2016-04-20 | 2016-04-22 |
| Travis | 2018-08-14 | 2018-08-16 |
| Arthur | 2016-04-01 | 2016-04-03 |
| Benjamin | 2014-01-01 | 2014-01-03 |
+----------+--------------+----------------------------------------+

To add 2 months to student enrollment dates:

SELECT fname, day_enrolled, DATE_ADD(day_enrolled, INTERVAL 2 MONTH)
FROM students;
+----------+--------------+------------------------------------------+
| fname | day_enrolled | DATE_ADD(day_enrolled, INTERVAL 2 MONTH) |
+----------+--------------+------------------------------------------+
| Sky | 2015-12-03 | 2016-02-03 |
| Ben | 2016-04-20 | 2016-06-20 |
| Travis | 2018-08-14 | 2018-10-14 |
| Arthur | 2016-04-01 | 2016-06-01 |
| Benjamin | 2014-01-01 | 2014-03-01 |
+----------+--------------+------------------------------------------+

Negative intervals

To subtract 1 day from a date:

SELECT DATE_ADD('2020-01-01', INTERVAL -1 DAY);
+-----------------------------------------+
| DATE_ADD('2020-01-01', INTERVAL -1 DAY) |
+-----------------------------------------+
| 2019-12-31 |
+-----------------------------------------+

Note that there is a separate method DATE_SUB(~) specifically for subtracting intervals from a date / datetime.

List of units

The below table represents a list of units that are supported:

Unit

Expected Input Format

MICROSECOND

MICROSECONDS

SECOND

SECONDS

MINUTE

MINUTES

HOUR

HOURS

DAY

DAYS

WEEK

WEEKS

MONTH

MONTHS

QUARTER

QUARTERS

YEAR

YEARS

SECOND_MICROSECOND

'SECONDS.MICROSECONDS'

MINUTE_MICROSECOND

'MINUTES:SECONDS.MICROSECONDS'

MINUTE_SECOND

'MINUTES:SECONDS'

HOUR_MICROSECOND

'HOURS:MINUTES:SECONDS.MICROSECONDS'

HOUR_SECOND

'HOURS:MINUTES:SECONDS'

HOUR_MINUTE

'HOURS:MINUTES'

DAY_MICROSECOND

'DAYS HOURS:MINUTES:SECONDS.MICROSECONDS'

DAY_SECOND

'DAYS HOURS:MINUTES:SECONDS'

DAY_MINUTE

'DAYS HOURS:MINUTES'

DAY_HOUR

'DAYS HOURS'

YEAR_MONTH

'YEARS-MONTHS'

mail
Join our newsletter for updates on new DS/ML comprehensive guides (spam-free)
robocat
Published by Arthur Yanagisawa
Edited by 0 others
Did you find this page useful?
thumb_up
thumb_down
thumb_up
0
thumb_down
0
chat_bubble_outline
0
settings
Enjoy our search
Hit / to insta-search docs and recipes!