手記
この関数は、意味のない結果を返す可能性があるため、視覚的な計算
現在のコンテキストの日付から、指定した間隔で前後にシフトされた日付の列を含むテーブルを返します。
構文
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)
特殊な動作
選択に過去 2 日間の月が含まれる場合、DATEADD は "拡張" セマンティクスを使用し、月末までの日数を含めます。 たとえば、2013 年 2 月 27 日と 28 日を選択に含め、月を追加すると、DATEADD は 3 月 27 日から 31 日に戻ります。
この動作は、過去 2 日間の月が選択範囲に含まれている場合にのみ発生します。 2 月 27 日のみが選択されている場合は、3 月 27 日に移動します。
= DATEADD(DateTime[DateKey], 1, month)