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