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