DATEADD 函数

返回一个表,该表包含由日期构成的一列,这些日期是在时间上从当前上下文中的日期前移或后移指定间隔数目的日期。

语法

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

参数

术语

定义

dates

包含日期的列。

number_of_intervals

一个整数,指定要从日期中加上或减去的间隔数。

interval

日期按其轮换的间隔。 间隔值可以是以下值之一:year、quarter、month、day

返回值

包含由日期值构成的单列的表。

注释

备注

若要了解有关上下文如何影响公式结果的详细信息,请参阅Context

dates 参数可以是以下任何项:

  • 对日期/时间列的引用

  • 返回由日期/时间值构成的单列的表表达式

  • 定义由日期/时间值构成的单列表的布尔表达式

备注

CALCULATE 函数 一文中介绍了针对布尔表达式的约束。

如果为 number_of_intervals 指定的数目是正数,则 dates 中的日期将在时间中向前移;如果该数目是负数,则日期 dates 中的日期将在时间中向后轮换。

interval 参数是枚举,而非字符串集;因此,不应该用引号将值引起来。 此外,值 year、quarter、month、day 在使用时应该完整拼写。

结果表只包括在 dates 列中存在的日期。

不支持在 DirectQuery 模式下使用此 DAX 函数。 有关 DirectQuery 模型中的限制的详细信息,请参阅 https://go.microsoft.com/fwlink/?LinkId=219172

示例:轮换日期集

说明

下面的公式计算当前上下文中日期之前一年的日期。

代码

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

请参阅

其他资源

时间智能函数 (DAX)

日期和时间函数 (DAX)

获取示例数据