TOTALYTD
aplica-se a:coluna calculada
tabela calculada
medida
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 de ano a ano do expression
no contexto atual.
Sintaxe
TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])
Parâmetros
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. |
Valor de retorno
Um valor escalar que representa o expression
avaliado para o dates
atual do ano até o momento.
Comentários
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).
Exemplo
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])