TOTALYTD 函数
计算当前上下文中 expression 的年初至今值。
语法
TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])
参数
参数 |
定义 |
|---|---|
expression |
一个返回标量值的表达式。 |
dates |
包含日期的列。 |
filter |
（可选）指定要应用到当前上下文的筛选器的表达式。 |
year_end_date |
（可选）具有定义年末日期的日期的文字字符串。 默认值为 12 月 31 日。 |
返回值
一个标量值，该值表示为当前年初至今日期 dates 计算的 expression。
注释
备注
若要了解有关上下文如何影响公式结果的详细信息，请参阅Context。
dates 参数可以是以下任何项：
对日期/时间列的引用
返回由日期/时间值构成的单列的表表达式
定义由日期/时间值构成的单列表的布尔表达式
备注
在 CALCULATE 函数 一文中介绍了针对布尔表达式的约束。
备注
筛选表达式具有 CALCULATE 函数 主题中介绍的限制。
year_end_date 参数是日期的字符串文字，处于创建工作簿的客户端所在的区域设置中。 日期的年份部分不需要，因此将被忽略。
例如，下面的公式在 EN-US 区域设置工作簿中将（会计）year_end_date 指定为 6/30。
=TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey], ALL(‘DateTime’), “6/30”)
在该示例中，year_end_date 可以指定为“6/30”、“Jun 30”、“30 June”或者解析为 month/day 的任何字符串。 但是，建议您使用“month/day”（如下所示）指定 year_end_date，以便确保字符串解析为日期。
不支持在 DirectQuery 模式下使用此 DAX 函数。 有关 DirectQuery 模型中的限制的详细信息，请参阅 https://go.microsoft.com/fwlink/?LinkId=219172。
示例
下面的公式示例创建一个度量值，该度量值为 Internet 销售计算“年度运行总计”或“年度运行总和”。
为了阐释此示例的工作方式，创建一个数据透视表，并且向该数据透视表的**“行标签”区域添加三个字段：CalendarYear、CalendarQuarter 和 MonthNumberOfYear。 然后使用在代码部分中定义的公式，将名为 Year-to-date Total 的度量值添加到该数据透视表的“值”**区域。
代码
=TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])