MySQL SUBDATE() 函数使用指南

MySQL SUBDATE() 函数在指定的日期/时间上减去指定到时间间隔加并返回新的日期/时间。

SUBDATE() 语法

这是 MySQL SUBDATE() 函数的语法:

SUBDATE(date, days)
SUBDATE(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

返回值

SUBDATE() 函数从指定的日期/时间减去指定的时间间隔,并返回一个新的日期/时间。SUBDATE() 函数的返回值和参数有关:

  • 如果 date 参数是 DATE 类型,并且时间间隔为 YEAR, MONTH 或者 DAY,返回 DATE
  • 如果 date 参数是 DATE 类型,并且时间间隔为 HOURS, MINUTES 或者 SECONDS,返回 DATETIME
  • 如果 date 参数是 DATETIME 类型,返回 DATETIME
  • 如果 date 参数是 TIME 类型,并且时间间隔为 YEAR, MONTH 或者 DAY,返回 DATETIME
  • 如果 date 参数是 TIME 类型,并且计算只涉及 HOURS, MINUTESSECONDS 部分,返回 TIME。(开始于 MySQL 8.0.28)
  • 其他情况下返回字符串。

SUBDATE() 示例

这里是几个 SUBDATE() 函数的示例。

示例 1

SELECT
    SUBDATE('2020-06-10', 10),
    SUBDATE('2020-06-10', -10)\G
 SUBDATE('2020-06-10', 10): 2020-05-31
SUBDATE('2020-06-10', -10): 2020-06-20

示例 2

SELECT
    SUBDATE('2020-06-10', INTERVAL 10 DAY),
    SUBDATE('2020-06-10', INTERVAL 10 HOUR)\G
 SUBDATE('2020-06-10', INTERVAL 10 DAY): 2020-05-31
SUBDATE('2020-06-10', INTERVAL 10 HOUR): 2020-06-09 14:00:00

示例 3

SELECT
    SUBDATE('2020-06-10 10:00:00', INTERVAL 10 HOUR),
    SUBDATE('2020-06-10 10:00:00', INTERVAL 10 MINUTE)\G
  SUBDATE('2020-06-10 10:00:00', INTERVAL 10 HOUR): 2020-06-10 00:00:00
SUBDATE('2020-06-10 10:00:00', INTERVAL 10 MINUTE): 2020-06-10 09:50:00

示例 4

SELECT
    SUBDATE(CURDATE(), INTERVAL 10 HOUR),
    SUBDATE(NOW(), INTERVAL 10 MINUTE)\G
SUBDATE(CURDATE(), INTERVAL 10 HOUR): 2022-04-10 14:00:00
  SUBDATE(NOW(), INTERVAL 10 MINUTE): 2022-04-11 08:56:43

这里,我们使用了 CURDATE() 函数返回当前的日期,使用 NOW() 函数返回当前日期时间。