TIMESTAMPDIFF()

Overview

Returns arg2 - arg1, where the args are date or datetime expressions. One expression may be a date and the other a datetime, with a date value treated as a datetime having the time part '00:00:00' where necessary.

See also: Functions in 10.6 ES, in 10.6 CS, in 10.5 ES, in 10.5 CS, in 10.4 ES, in 10.4 CS, in 10.3 ES, in 10.3 CS, in 10.2 ES, and in 10.2 CS

EXAMPLES

SELECT TIMESTAMPDIFF(MONTH,'2020-02-01','2019-02-01');
+------------------------------------------------+
| TIMESTAMPDIFF(MONTH,'2020-02-01','2019-02-01') |
+------------------------------------------------+
|                                            -12 |
+------------------------------------------------+
SELECT TIMESTAMPDIFF(MONTH,'2019-02-01','2020-02-01');
+------------------------------------------------+
| TIMESTAMPDIFF(MONTH,'2019-02-01','2020-02-01') |
+------------------------------------------------+
|                                             12 |
+------------------------------------------------+

CHANGE HISTORY

Release Series

History

10.6 Enterprise

  • Present starting in MariaDB Enterprise Server 10.6.4-1.

10.6 Community

  • Present starting in MariaDB Community Server 10.6.0.

10.5 Enterprise

  • Present starting in MariaDB Enterprise Server 10.5.3-1.

10.5 Community

  • Present starting in MariaDB Community Server 10.5.0.

10.4 Enterprise

  • Present starting in MariaDB Enterprise Server 10.4.6-1.

10.4 Community

  • Present starting in MariaDB Community Server 10.4.0.

10.3 Enterprise

  • Present starting in MariaDB Enterprise Server 10.3.16-1.

10.3 Community

  • Present starting in MariaDB Community Server 10.3.0.

10.2 Enterprise

  • Present starting in MariaDB Enterprise Server 10.2.25-1.

10.2 Community

  • Present starting in MariaDB Community Server 10.2.0.

EXTERNAL REFERENCES