DATEADD
注意
不建議將此函式用於 視覺計算,因為它可能會傳回毫無意義的結果。
傳回包含日期數據行的數據表,依目前內容中日期的指定間隔數目來往前或向後移動。
語法
DATEADD(<dates>,<number_of_intervals>,<interval>)
參數
術語 | 定義 |
---|---|
dates |
包含日期的數據行。 |
number_of_intervals |
整數,指定要加入或減去日期的間隔數目。 |
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)