DATETIME_ADD

将指定的时间间隔添加到日期或日期和时间。

用法示例

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

语法

DATETIME_ADD( datetime_expression, INTERVAL integer part )

参数

  • datetime_expression - 日期或日期和时间字段或表达式。
  • integer - 表示要添加的部分数量的整数数字字段或表达式。
  • part - 要添加的时间测量单位。DATETIME_ADD 支持以下 part 值：
    • MICROSECOND：适用于日期和时间字段或表达式。
    • MILLISECOND：适用于日期和时间字段或表达式。
    • SECOND：适用于日期和时间字段或表达式。
    • MINUTE：适用于日期和时间字段或表达式。
    • HOUR：适用于日期和时间字段或表达式。
    • DAY
    • WEEK：此日期部分从星期日开始。
    • ISOWEEK：使用 ISO 8601 格式的周边界值。ISO 格式的周从星期一开始。
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR：使用 ISO 8601 格式的周编号年份边界值。ISO 格式年份的边界值是其星期四属于相应公历年的第一周的星期一。

返回数据类型

日期和时间

示例

示例公式 输出
DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)

2023 年 1 月 25 日下午 3:40:00
DATETIME_ADD(DATE "2023-01-25", INTERVAL 5 DAY)

2023 年 1 月 30 日上午 12:00:00

备注

此函数不适用于兼容模式日期类型。

使用 MONTH、QUARTER 或 YEAR 部分时，如果生成的日期是（或接近）月份的最后一天，DATETIME_ADD 会返回该月的最后一天。如果生成的日期中的月份的天数少于起始日期中的月份的天数，则可能会发生这种情况。

例如，如果日期 = 2020 年 8 月 31 日，DATETIME_ADD(Date, INTERVAL 1 MONTH) 会返回 2020 年 9 月 30 日。