Partilhar via


TOTALYTD

Aplica-se a:Coluna calculadaTabela calculadaMedidaCá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> 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 (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 o expression avaliado para o ano atual até a data dates ou calendar.

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.

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

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

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

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

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

ALL CALCULATE DATESYTD TOTALMTD TOTALQTD TOTALWTD