Skip to main content
Version: Latest-3.3

hours_diff

Description

Returns the hour difference between two date expressions (expr1expr2), accurate to the hour.

Syntax

BIGINT hours_diff(DATETIME expr1, DATETIME expr2);

Parameters

  • expr1: the end time. It must be of the DATETIME type.

  • expr2: the start time. It must be of the DATETIME type.

Return value

Returns a BIGINT value.

NULL is returned if the date does not exist, for example, 2022-02-29.

Examples

select hours_diff('2010-11-30 23:59:59', '2010-11-30 20:58:59');
+----------------------------------------------------------+
| hours_diff('2010-11-30 23:59:59', '2010-11-30 20:58:59') |
+----------------------------------------------------------+
| 3 |
+----------------------------------------------------------+