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 | SUBTIME 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 SUBTIME(~) method subtracts the specified time interval from a time or datetime value.

Parameters

1. expr1 | time/datetime

The time or datetime to subtract the time interval from.

2. expr2 | time

The time interval to subtract from expr1.

Return value

The result of subtracting the specified time interval from expr1.

Examples

Basic usage

To subtract a time from a datetime:

SELECT SUBTIME('2019-12-31 23:59:59.999999', '1:1:1.000002');
+-------------------------------------------------------+
| SUBTIME('2019-12-31 23:59:59.999999', '1:1:1.000002') |
+-------------------------------------------------------+
| 2019-12-31 22:58:58.999997 |
+-------------------------------------------------------+

To subtract a time from a time:

SELECT SUBTIME('12:30:30.999999', '1:1:1.000002');
+--------------------------------------------+
| SUBTIME('12:30:30.999999', '1:1:1.000002') |
+--------------------------------------------+
| 11:29:29.999997 |
+--------------------------------------------+

Negative time

To subtract negative time (i.e. add a time):

SELECT SUBTIME('12:30:30.999999', '-1:1:1.000002');
+---------------------------------------------+
| SUBTIME('12:30:30.999999', '-1:1:1.000002') |
+---------------------------------------------+
| 13:31:32.000001 |
+---------------------------------------------+

Note that there is a separate method ADDTIME(~) specifically for adding time intervals to a time / datetime.

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!