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 日。