通知

このヘルプセンターは Cloud に移行されます。移行の詳細

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

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

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

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

関連資料

この情報は役に立ちましたか?

改善できる点がありましたらお聞かせください。

さらにサポートが必要な場合

次の手順をお試しください。

true
Looker Studio の新機能

新機能と変更点についてご確認ください。Looker Studio リリースノートが Google Cloud で公開されました。

検索
検索をクリア
検索を終了
Google アプリ
メインメニュー