TOTALYTD
Aplica-se a:Coluna calculada
Tabela calculada
Medida
Cálculo visual
Nota
Esta função é desencorajada para uso em cálculos visuais, pois provavelmente retorna resultados sem sentido.
Avalia o valor acumulado do 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 |
(facultativo) Uma expressão que especifica um filtro a ser aplicado ao contexto atual. |
year_end_date |
(facultativo) Uma cadeia de caracteres literal com uma data que define a data de fim de ano. O padrão é 31 de dezembro. |
Valor de retorno
Um valor escalar que representa a expression
avaliada para o ano atual até a data dates
.
Observações
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 booleana que define uma tabela de coluna única de valores de data/hora.
As restrições nas expressões booleanas 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 que a localidade do cliente onde 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 year_end_date (fiscal) de 6/30 em uma pasta de trabalho de 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 June" ou qualquer string que resolva para um mês/dia. No entanto, é recomendável especificar year_end_date usando "mês/dia" (conforme mostrado) para garantir que a cadeia de caracteres seja resolvida para uma data.
Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).
Exemplo
A fórmula de exemplo a seguir cria uma medida que calcula o "total do ano corrido" ou a "soma do ano corrente" para vendas pela Internet.
= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])