MariaDB ADDDATE() 函数使用指南

在 MariaDB 中,ADDDATE() 函数在指定的日期/时间上加上指定到时间间隔加并返回运算结果。

MariaDB ADDDATE() 语法

这是 MariaDB ADDDATE() 函数的语法:

ADDDATE(date, days)
ADDDATE(date, INTERVAL value unit)

参数

date
必需的。需要操作的日期。
days
必需的。在 date 上加上的天数。
value
必需的。时间/日期间隔。正数和负数都是允许的。
unit
必需的。时间/日期间隔的单位。

时间/日期间隔的单位可以是以下值中的一个:

  • MICROSECOND
  • SECOND
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
  • YEAR
  • SECOND_MICROSECOND
  • MINUTE_MICROSECOND
  • MINUTE_SECOND
  • HOUR_MICROSECOND
  • HOUR_SECOND
  • HOUR_MINUTE
  • DAY_MICROSECOND
  • DAY_SECOND
  • DAY_MINUTE
  • DAY_HOUR
  • YEAR_MONTH

如果您不提供参数或提供了错误数量的参数,MariaDB 将报告一个错误:ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near ')' at line 1

返回值

MariaDB ADDDATE() 函数指定的日期/时间添加指定的时间间隔,并返回一个新的日期/时间。ADDDATE() 函数的返回值和参数有关:

  • 如果 date 参数是 DATE 类型,并且时间间隔为 YEAR, MONTH 或者 DAY,返回 DATE
  • 如果 date 参数是 DATE 类型,并且时间间隔为 HOURS, MINUTES 或者 SECONDS,返回 DATETIME
  • 如果 date 参数是 DATETIME 类型,返回 DATETIME
  • 如果 date 参数是 TIME 类型,并且时间间隔为 YEAR, MONTH 或者 DAY,返回 DATETIME
  • 其他情况下返回字符串。

MariaDB ADDDATE() 示例

示例 1 – 添加天数

要为给定的日期添加天数,请使用以下带有 MariaDB ADDDATE() 函数的语句:

SELECT ADDDATE('2023-01-05', 5);

输出:

+--------------------------+
| ADDDATE('2023-01-05', 5) |
+--------------------------+
| 2023-01-10               |
+--------------------------+

MariaDB ADDDATE() 允许您为一个日期时间值添加天数:

SELECT ADDDATE('2023-01-05 10:11:12', 5);

输出:

+-----------------------------------+
| ADDDATE('2023-01-05 10:11:12', 5) |
+-----------------------------------+
| 2023-01-10 10:11:12               |
+-----------------------------------+

示例 2 – INTERVAL

MariaDB ADDDATE() 允许提供一个 INTERVAL 类型的值:

SELECT
  ADDDATE('2023-01-05', INTERVAL 10 DAY),
  ADDDATE('2023-01-05', INTERVAL 10 HOUR),
  ADDDATE('2023-01-05 10:11:12', INTERVAL 10 HOUR),
  ADDDATE('2023-01-05 10:11:12', INTERVAL 10 MINUTE)\G

输出:

            ADDDATE('2023-01-05', INTERVAL 10 DAY): 2023-01-15
           ADDDATE('2023-01-05', INTERVAL 10 HOUR): 2023-01-05 10:00:00
  ADDDATE('2023-01-05 10:11:12', INTERVAL 10 HOUR): 2023-01-05 20:11:12
ADDDATE('2023-01-05 10:11:12', INTERVAL 10 MINUTE): 2023-01-05 10:21:12

示例 3 – 减去天数

MariaDB ADDDATE() 允许通过提供要给负值以减去给定的时间间隔:

例:

SELECT
  ADDDATE('2023-01-05', -5),
  ADDDATE('2023-01-05', INTERVAL -5 DAY)\G

输出:

             ADDDATE('2023-01-05', -5): 2022-12-31
ADDDATE('2023-01-05', INTERVAL -5 DAY): 2022-12-31

结论

在 MariaDB 中,ADDDATE() 函数在指定的日期/时间上加上指定到时间间隔加并返回运算结果。