DATEADD

注意

不建議將此函式用於視覺計算，因為它可能會傳回毫無意義的結果。

傳回包含日期資料行的資料表，依指定間隔數從目前內容中的日期開始，向前或向後移動時間。

語法

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

詞彙	定義
日期	包含日期的資料行。
number_of_intervals	整數，指定要加上或減去日期的間隔數。
interval	日期移動所依據的間隔。 interval 值可以是下列其中一項：`year`、`quarter`、`month`、`day`

包含單一日期值資料行的資料表。

dates 引數可以是下列任何一項：

日期/時間資料行的參考、
傳回單一日期/時間值資料行的資料表運算式、
定義日期/時間值單一資料行資料表的布林運算式。

注意

CALCULATE 函式主題會描述布林運算式的條件約束。
如果指定給 number_of_intervals 的數字是正數，則 dates 中的日期會將時間往前移；如果數字是負數，則 dates 中的日期會將時間往後移。
interval 參數是列舉而非一組字串；因此，值的前後不應加上引號。此外，使用 year、quarter、month、day 值時應該完整拼寫。
結果資料表只包含存在於 dates 資料行中的日期。
如果目前內容中的日期未形成連續間隔，則函式會傳回錯誤。
在計算結果欄或資料列層級安全性 (RLS) 規則中使用時，不支援在 DirectQuery 模式中使用此函式。

下列公式會計算目前內容日期的前一年日期。

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