TOTALYTD

Nota

Esta função é desencorajada para uso em cálculos visuais, pois provavelmente retorna resultados sem sentido.

Avalia o year-a-datevalue do expression no contexto atual.

Sintaxe

TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])

Parâmetro	Definição
`expression`	Uma expressão que retorna uma valueescalar .
`dates`	Uma coluna que contains datas.
`filter`	(facultativo) Uma expressão que especifica um filter a ser aplicado ao contexto atual.
`year_end_date`	(facultativo) Uma cadeia de caracteres literal com um date que define o year-end date. O padrão é 31 de dezembro.

Um value escalar que representa o expression avaliado para o yearatual -to-datedates.

O argumento dates pode ser qualquer um dos seguintes:
- Uma referência a uma coluna date/time.
- Uma expressão de tabela que retorna uma única coluna de date/timevalues.
- Uma expressão booleana que define uma tabela de coluna única de date/timevalues.
As restrições nas expressões booleanas são descritas no tópico CALCULATE.
A expressão filter tem restrições descritas no tópico, CALCULATE.
O parâmetro year_end_date é um literal de cadeia de caracteres de um date, na mesma localidade que a localidade do cliente onde a pasta de trabalho foi criada. A parte year do date é not necessária and é ignorada. Por exemplo, a fórmula a seguir especifica um year_end_date (fiscal) de 6/30 em uma pasta de trabalho de localidade EN-US.
```
= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey], ALL('DateTime'), "6/30")
```
Neste exemplo, year_end_date pode ser especificado como "6/30", "jun 30", "30 June" or qualquer string que resolva para um month/day. No entanto, é recomendável especificar year_end_date usando "month/day" (conforme mostrado) para garantir que a cadeia de caracteres seja resolvida para um date.
Esta função not é suportada para uso no modo DirectQuery quando usada em colunas calculadas or regras de segurança em nível de linha (RLS).

A fórmula de sample a seguir cria um measure que calcula o or deyear deyearsumem execução para vendas pela Internet.

= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])