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> or <calendar>[,<filter>][,<year_end_date>])

Parâmetros

Parâmetro Definição
expression Uma expressão que retorna um valor escalar.
dates or calendar Uma coluna que contém datas ou uma referência de calendário
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 ano atual até a data dates ou calendar.

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.

  • O year_end_date parâmetro não deve ser especificado quando um calendário é usado.

  • 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])

Exemplo de inteligência de tempo baseada em calendário

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 em termos de calendário fiscal.

= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]), FiscalCalendar)

ALL CALCULATE DATESYTD TOTALMTD TOTALQTD TOTALWTD