Compartilhar via


TOTALYTD

aplica-se a:coluna calculadatabela calculadamedidacá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 datesatual 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])

ALL CALCULATE DATESYTD TOTALMTD TOTALQTD