TOTALYTD

Observação

Essa função não é recomendada para uso em cálculos visuais, pois provavelmente retornará resultados sem sentido.

Avalia o valor de ano a ano do expression no contexto atual.

Sintaxe

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

Parâmetro	Definição
`expression`	Uma expressão que retorna um valor escalar.
`dates`	Uma coluna que contém datas.
`filter`	(opcional) Uma expressão que especifica um filtro a ser aplicado ao contexto atual.
`year_end_date`	(opcional) Uma cadeia de caracteres literal com uma data que define a data de término do ano. O padrão é 31 de dezembro.

Um valor escalar que representa o expression avaliado para o datesatual do ano até o momento.

O argumento dates pode ser qualquer um dos seguintes:
- Uma referência a uma coluna de data/hora.
- Uma expressão de tabela que retorna uma única coluna de valores de data/hora.
- Uma expressão booliana que define uma tabela de coluna única de valores de data/hora.
Restrições em expressões boolianas 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 uma data, na mesma localidade da localidade do cliente em que a pasta de trabalho foi criada. A parte do ano da data não é necessária e é ignorada. Por exemplo, a fórmula a seguir especifica um valor para (fiscal) year_end_date igual a 6/30 em uma pasta de trabalho na localidade EN-US.
```
= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey], ALL('DateTime'), "6/30")
```
Neste exemplo, year_end_date pode ser especificado como "30/6", "Jun 30", "30 de junho" ou qualquer cadeia de caracteres que seja resolvida para um mês/dia. No entanto, é recomendável que você especifique year_end_date usando "mês/dia" (conforme mostrado) para garantir que a cadeia de caracteres seja resolvida para uma data.
Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).

A fórmula de exemplo a seguir cria uma medida que calcula o "total de execução do ano" ou a "soma de execução do ano" para vendas pela Internet.

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