Partilhar via

  • Artigo

Função TOTALYTD (DAX)

Avalia o valor desde o início do ano da 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 definição de data de fim de ano. O padrão é 31 de dezembro.

Valor de retorno

Um valor escalar que representa a expression avaliada para as dates desde o início do ano atual.

Comentários

ObservaçãoObservação

Para entender melhor como o contexto afeta os resultados das fórmulas, consulte Contexto em fórmulas DAX.

O argumento dates pode ser qualquer um destes:

  • 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 com uma única coluna de valores de data/hora.

ObservaçãoObservação

As restrições em expressões boolianas são descritas no tópico Função CALCULATE (DAX).
ObservaçãoObservação

A expressão filter contém restrições descritas no tópico Função CALCULATE (DAX).

O parâmetro year_end_date é uma cadeia de caracteres literal de uma data, na mesma localidade do cliente onde a pasta de trabalho foi criada. A parte de ano da data é ignorada.

Exemplo

A fórmula de exemplo a seguir cria uma medida que calcula o 'total acumulado no ano' ou a 'soma acumulada no ano' das vendas pela Internet.

Para ver como isso funciona, crie uma Tabela Dinâmica e adicione os campos CalendarYear, CalendarQuarter e MonthNumberOfYear à área Rótulos de Linha da Tabela Dinâmica. Em seguida, adicione uma medida denominada Year-to-date Total, usando a fórmula definida na seção de código, à área Valores da Tabela Dinâmica.

Código

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