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 日 午前 0 時 00 分 00 秒

メモ

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

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

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