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)