MySQL
keyboard_arrow_down 295 guides
chevron_leftDate and Time
Method ADDDATEMethod ADDTIMEMethod CONVERT_TZMethod CURDATEMethod CURRENT_DATEMethod CURRENT_TIMEMethod CURRENT_TIMESTAMPMethod CURTIMEMethod DATEMethod DATE_ADDMethod DATE_FORMATMethod DATE_SUBMethod DATEDIFFMethod DAYMethod DAYNAMEMethod DAYOFMONTHMethod DAYOFWEEKMethod DAYOFYEARMethod EXTRACTMethod FROM_DAYSMethod FROM_UNIXTIMEMethod GET_FORMATMethod HOURMethod LAST_DAYMethod LOCALTIMEMethod LOCALTIMESTAMPMethod MAKEDATEMethod MAKETIMEMethod MICROSECONDMethod MINUTEMethod MONTHMethod MONTHNAMEMethod NOWMethod PERIOD_ADDMethod PERIOD_DIFFMethod QUARTERMethod SEC_TO_TIMEMethod SECONDMethod STR_TO_DATEMethod SUBDATEMethod SUBTIMEMethod SYSDATEMethod TIMEMethod TIME_FORMATMethod TIME_TO_SECMethod TIMEDIFFMethod TIMESTAMPMethod TIMESTAMPADDMethod TIMESTAMPDIFFMethod TO_DAYSMethod TO_SECONDSMethod UNIX_TIMESTAMPMethod UTC_DATEMethod UTC_TIMEMethod UTC_TIMESTAMPMethod WEEKMethod WEEKDAYMethod WEEKOFYEARMethod YEARMethod YEARWEEK
check_circle
Mark as learned thumb_up
0
thumb_down
0
chat_bubble_outline
0
Comment auto_stories Bi-column layout
settings
MySQL | SUBTIME method
schedule Aug 10, 2023
Last updated local_offer
Tags MySQL
tocTable of Contents
expand_more Master the mathematics behind data science with 100+ top-tier guides
Start your free 7-days trial now!
Start your free 7-days trial now!
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.
Published by Arthur Yanagisawa
Edited by 0 others
Did you find this page useful?
thumb_up
thumb_down
Comment
Citation
Ask a question or leave a feedback...
Official MySQL Documentation
https://dev.mysql.com/doc/refman/8.0/en/date-and-time-functions.html#function_subtime
thumb_up
0
thumb_down
0
chat_bubble_outline
0
settings
Enjoy our search
Hit / to insta-search docs and recipes!
