TOTALYTD
Aplica-se a:
Coluna calculadaTabela calculadaMedida
Cálculo visual
Observação
Essa função não é recomendada para uso em cálculos visuais, pois provavelmente retornará resultados sem sentido.
Avalia o valor do ano até a data da expressão no contexto atual.
Sintaxe
TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])
Parâmetros
| Parâmetro | Definição |
|---|---|
| expressão | Uma expressão que retorna um valor escalar. |
| datas | 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. |
Valor retornado
Um valor escalar que representa a expressão avaliada para as datas do ano atual até a data.
Comentários
O argumento dates pode ser 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.
As restrições em expressões boolianas são descritas no tópico CALCULATE.
A expressão filter tem as 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 que a usada pelo cliente em que a pasta de trabalho foi criada. A parte de ano da data não é obrigató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 "6/30", "Jun 30", "30 de junho" ou qualquer cadeia de caracteres que seja resolvida para um mês/dia. No entanto, é recomendável especificar year_end_date usando "mês/dia" (como mostrado) para garantir que a cadeia de caracteres seja resolvida como uma data.
Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.
Exemplo
A fórmula de exemplo a seguir cria uma medida que calcula o "total do ano atual" ou a "soma do ano atual" de vendas na Internet.
= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])