DATEADD

適用於:導出數據行計算數據表Measure視覺計算

注意

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

傳回 contains 日期數據行的數據表,time 從目前內容中的日期指定間隔數目往後 or 移位 time。

語法

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

參數

術語 定義
dates contains 日期的數據行。
number_of_intervals 整數,指定要加入至 or 從日期減去的間隔數目。
interval 要轉移日期的間隔。 間隔的 value 可以是下列其中一項:yearquartermonthday

傳回 value

包含單一資料列的數據表,datevalues。

言論

dates 自變數可以是下列任一項:

  • date/time 數據行的參考,

  • 傳回單一資料行的數據表運算式,date/timevalues、

  • 布爾表達式,定義 date/timevalues的單一數據行數據表。

    注意

    布林運算式的條件約束會在 主題中說明,CALCULATE 函式

  • If 為 number_of_intervals 指定的數位為正數,dates 中的日期會往前移動 time;if 數位為負數,dates 中的日期會移回 time。

  • interval 參數是列舉,not 一組字串;因此,values 應以引弧括住 not。 此外,values:yearquartermonthday 在使用時應該完整拼字。

  • 結果數據表只包含存在於 dates 資料行中的日期。

  • If 目前內容中的日期會 not 形成連續的間隔,函式會傳回 error。

  • 在匯出數據行中使用 or 數據列層級安全性 (RLS) 規則時,支援此函式 not 用於 DirectQuery 模式。

範例 - 轉移一組日期

下列公式會計算目前內容中日期之前一 year 日期。

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

Time 智慧函式
Date and time 函式