DATEADD 関数
現在のコンテキストの日付から、指定された間隔の数だけ時間を進めたか戻した日付の列を含むテーブルを返します。
構文
DATEADD(<dates>,<number_of_intervals>,<interval>)
パラメーター
項目 |
定義 |
dates |
日付が格納されている列。 |
number_of_intervals |
日付に加算または日付から減算する間隔の数を示す整数。 |
interval |
日付をシフトする間隔。 間隔の値には、year、quarter、month、day のいずれかを指定できます。 |
戻り値
日付値の単一列から成るテーブル。
説明
注 |
---|
コンテキストが数式の結果に与える影響の詳細については、「DAX の数式のコンテキスト」を参照してください。 |
dates 引数には、次のいずれかを指定できます。
日付/時刻列への参照。
日付/時刻値の単一列を返すテーブル式。
日付/時刻値の単一列テーブルを定義するブール式。
注 |
---|
ブール式の制約の詳細については、「CALCULATE 関数」を参照してください。 |
number_of_intervals に指定された数値が正の値の場合、dates の日付は時間的に進められます。負の値の場合、dates の日付は時間的に戻ります。
interval パラメーターは、文字列のセットではなく列挙値です。そのため、値を引用符で囲まないでください。 また、year、quarter、month、および day の値を使用する際にはフル スペルで記述してください。
結果のテーブルに含まれるのは、dates 列に存在する日付だけです。
この DAX 関数は DirectQuery モードでは使用できません。 DirectQuery モデルの制限の詳細については、https://go.microsoft.com/fwlink/?LinkId=219172 を参照してください。
例: 一連の日付を変更する
説明
次の数式は、現在のコンテキストにおける日付の 1 年前の日付を計算します。
コード
=DATEADD(DateTime[DateKey],-1,year)