MySQL - TIMESTAMPDIFF() 函数

---

---

MySQL 的 **TIMESTAMPDIFF()** 函数用于计算两个日期时间或日期表达式之间的差值。

此函数接受两个日期时间或日期表达式作为参数值，计算它们之间的差值并返回结果。其中一个参数可以是日期，另一个可以是日期时间表达式。

如果任何一个参数传递为 NULL，则此函数返回 NULL。

语法

以下是 MySQL TIMESTAMPDIFF() 函数的语法：

TIMESTAMPDIFF(unit,datetime_expr1,datetime_expr2)

参数

此方法接受三个参数。下面描述了这些参数：

• **unit** 是由 expr 值表示的间隔类型，可以是 DAY、WEEK、MONTH、QUARTER、YEAR、HOUR、MINUTE、SECOND、MICROSECOND。

• **datetime_expr1 和 datetime_expr2** 是日期或日期时间表达式。

返回值

此函数返回两个日期时间表达式根据指定单位的差值。

示例

在以下示例中，我们使用 MySQL TIMESTAMPDIFF() 函数计算指定两个日期值的 **DAY** 差值：

SELECT TIMESTAMPDIFF(DAY, '1898-03-22', '2019-05-02') As Result;

输出

这将产生以下结果：

结果
44235

示例

在这里，我们计算两个日期值的 **QUARTER** 差值：

SELECT TIMESTAMPDIFF(QUARTER, '2022-11-29', '2023-11-29')
As Result;

输出

以下是输出：

结果
4

示例

在以下查询中，我们计算两个日期时间值的 **HOUR** 差值：

SELECT TIMESTAMPDIFF(HOUR,'2023-05-12 12:00:00','2023-05-13 12:00:00')
As Result;

输出

以下是输出：

结果
24

示例

在此示例中，我们使用以下 CREATE TABLE 查询创建了一个名为 **ORDERS** 的表：

CREATE TABLE ORDERS (
   OID INT NOT NULL,
   DATE VARCHAR (20) NOT NULL,
   CUSTOMER_ID INT NOT NULL,
   AMOUNT DECIMAL (18, 2)
);

现在，使用 INSERT 语句将以下记录插入 ORDERS 表中：

INSERT INTO ORDERS VALUES 
(102, '2009-10-08 00:00:00', 3, 3000.00),
(100, '2009-10-08 00:00:00', 3, 1500.00),
(101, '2009-11-20 00:00:00', 2, 1560.00),
(103, '2008-05-20 00:00:00', 4, 2060.00);

执行以下查询以获取上面创建的表中的所有插入记录：

Select * From ORDERS;

以下是 ORDERS 表：

OID	DATE	CUSTOMER_ID	AMOUNT
102	2009-10-08 00:00:00	3	3000.00
100	2009-10-08 00:00:00	3	1500.00
101	2009-11-20 00:00:00	2	1560.00
103	2008-05-20 00:00:00	4	2060.00

在这里，我们使用 MySQL TIMESTAMPDIFF() 函数计算“DATE”列与当前时间戳之间的年份差值：

SELECT OID, DATE, TIMESTAMPDIFF(YEAR , DATE, CURRENT_TIMESTAMP())
As Result FROM ORDERS;

输出

输出显示如下：

OID	DATE	结果
102	2009-10-08 00:00:00	14
100	2009-10-08 00:00:00	14
101	2009-11-20 00:00:00	13
103	2008-05-20 00:00:00	15