DATEADD

適用対象: 計算列計算テーブルメジャービジュアル計算

手記

この関数は、意味のない結果を返す可能性があるため、視覚的な計算使用することはお勧めしません。

現在のコンテキストの日付から、指定した間隔で前後にシフトされた日付の列を含むテーブルを返します。

構文

DATEADD(<dates>,<number_of_intervals>,<interval>)

用語	定義
`dates`	日付を含む列。
`number_of_intervals`	日付に加算または減算する間隔の数を指定する整数。
`interval`	日付をシフトする間隔。間隔の値には、`year`、`quarter`、`month`、`day` のいずれかを指定できます。

日付値の単一列を含むテーブル。

dates 引数には、次のいずれかを指定できます。

日付/時刻列への参照。
日付/時刻値の単一列を返すテーブル式。
日付/時刻値の単一列テーブルを定義するブール式。

手記

ブール式に対する制約については、関数トピックで説明します。
number_of_intervals に指定された数値が正の場合、dates の日付は時間内に移動されます。数値が負の場合、dates の日付は時間単位でシフトされます。
interval パラメーターは列挙体であり、文字列のセットではありません。したがって、値を引用符で囲む必要はありません。また、year、quarter、month、day の値は、それらを使用するときに完全にスペルする必要があります。
結果テーブルには、dates 列に存在する日付のみが含まれます。
現在のコンテキストの日付が連続した間隔を形成しない場合、関数はエラーを返します。
この関数は、計算列または行レベルセキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。

次の数式は、現在のコンテキストの日付の 1 年前の日付を計算します。

= DATEADD(DateTime[DateKey],-1,year)