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 年の境界は、対応するグレゴリオ暦年に木曜日が属している最初の週の月曜日です。

戻りデータの型

日付と時刻

例

Example formula Output
DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)

Jan 25, 2023, 3:40:00 PM

DATETIME_ADD(DATE "2023-01-25", INTERVAL 5 DAY)

Jan 30, 2023, 12:00:00 AM

メモ

この関数は、互換モードの日付タイプでは使用できません。

MONTH、QUARTER、YEAR のパーツを使用している際に、結果の日付が月の最終日（または最終日近く）になる場合、DATETIME_ADD は月の最終日を返します。これは、結果の日付の月の日数が、開始日の月の日数よりも少ない場合に発生する可能性があります。

たとえば、Date の値が August 31, 2020（2020 年 8 月 31 日）の場合、DATETIME_ADD(Date, INTERVAL 1 MONTH) は September 30, 2020（2020 年 9 月 30 日）を返します。