Função TOTALYTD
Avalia o valor desde o início do ano da expressão 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
.gif "Observação") Observaçã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ção |
|---|
As restrições em expressões boolianas são descritas no tópico Função CALCULATE. |
| Observação |
|---|
A expressão de filtro contém restrições descritas no tópico Função CALCULATE. |
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.
Esta função DAX não tem suporte para uso no modo DirectQuery. Para obter mais informações sobre limitações nos modelos DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219172.
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])