共用方式為


DATEADD

適用於:匯出數據行計算數據表量值視覺計算

注意

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

傳回包含日期數據行的數據表,依目前內容中日期的指定間隔數目來往前或向後移動。

語法

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

參數

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

傳回值

包含日期值單一數據行的數據表。

言論

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

  • 日期/時間數據行的參考,

  • 傳回日期/時間值單一數據行的數據表運算式,

  • 布爾表示式,定義日期/時間值的單一數據行數據表。

    注意

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

  • 如果為 number_of_intervals 指定的數位為正數,則 dates 中的日期會依時間向前移動;如果數位為負數,則 dates 中的日期會依時間移回。

  • interval 參數是列舉,而不是一組字串;因此,值不應以引號括住。 此外,使用值時,yearquartermonthday 應該完整拼字。

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

  • 如果目前內容中的日期未形成連續的間隔,函式會傳回錯誤。

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

範例 - 轉移一組日期

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

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

時間智慧函式日期和時間函式