MySQL - TIMESTAMPADD() 函式

---

---

MySQL 的TIMESTAMPADD()函式用於向日期時間或日期表示式新增指定的時間間隔。

時間間隔可以使用以下任何單位指定：MICROSECOND（微秒）、SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER 或 YEAR。它們使用相同的關鍵字指定。

如果任何引數傳遞為 NULL，則此函式返回 NULL。

語法

以下是 TIMESTAMPADD() 函式的語法：

TIMESTAMPADD(unit,interval,datetime_expr)

引數

此方法接受三個引數。具體描述如下：

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

• Interval 是表示要新增的時間間隔的表示式。

• datetime_expr 是需要新增時間間隔的日期或日期時間表達式。

返回值

此函式在向原始日期或時間新增指定的時間間隔後返回新的日期或時間值。

示例

在下面的查詢中，我們使用 MySQL TIMESTAMPADD() 函式向指定的日期新增 31 天：

SELECT TIMESTAMPADD(DAY, 31, '2023-05-01') As Result;

輸出

這將產生以下結果：

結果
2023-06-01

示例

這裡，我們向指定的 datetime 值新增 225 小時：

SELECT TIMESTAMPADD(HOUR, 225, '2023-05-23 20:40:32.88558')
As Result;

輸出

以下是輸出：

結果
2023-06-02 05:40:32.885580

示例

在下面的查詢中，我們從指定的日期值減去 20 天：

SELECT TIMESTAMPADD(DAY,-20,'2023-09-05') As Result;

輸出

以下是輸出：

結果
2023-08-16

示例

在此示例中，我們使用以下 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 TIMESTAMPADD() 函式向“DATE”列中的 datetime 值新增 10 年：

SELECT OID, DATE, TIMESTAMPADD(YEAR, 10, DATE)
As Result FROM ORDERS;

輸出

輸出如下所示：

OID	DATE	結果
102	2009-10-08 00:00:00	2019-10-08 00:00:00
100	2009-10-08 00:00:00	2019-10-08 00:00:00
101	2009-11-20 00:00:00	2019-11-20 12:00:00
103	2008-05-20 00:00:00	2018-05-20 00:00:00