Compartilhar via


PREVIOUSYEAR

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Nota

Essa função é desencorajada para uso em cálculos visuais pois provavelmente retorna resultados sem sentido.

Para entrada de coluna de data, retorna uma tabela que contém uma coluna de todas as datas do ano anterior, dada a última data na dates coluna, no contexto atual.

Para entrada de calendário, retorna todas as datas do ano anterior, com base na primeira data no contexto atual. A tabela contém todas as colunas marcadas primárias e colunas relacionadas a todos os tempos

Sintaxe

PREVIOUSYEAR(<dates> or <calendar>[,<year_end_date>])

Parâmetros

Prazo Definição
dates or calendar Uma coluna que contém datas ou uma referência de calendário
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. Esse parâmetro só é permitido quando a sintaxe da coluna de data é usada.

Valor de retorno

Para entrada de coluna de data, uma tabela que contém uma única coluna de valores de data.
Para entrada de calendário, uma tabela que contém todas as colunas marcadas primárias e colunas relacionadas a todos os tempos.

Observações

  • Essa função retorna todas as datas do ano anterior, considerando a data mais recente no parâmetro de entrada. Por exemplo, se a data mais recente no argumento dates se referir ao ano de 2009, essa função retornará todas as datas do ano de 2008, até o year_end_dateespecificado.

  • 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.

  • 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 é ignorada.

  • O year_end_date parâmetro só é permitido quando a sintaxe da coluna de data é usada.

  • 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 as vendas do ano anterior para vendas pela Internet.

= CALCULATE (
    SUM ( InternetSales_USD[SalesAmount_USD] ),
    PREVIOUSYEAR ( 'DateTime'[DateKey] )
)

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

A fórmula de exemplo a seguir cria uma medida que calcula as "vendas do trimestre anterior" para vendas pela Internet em termos de calendário fiscal.

= CALCULATE (
    SUM ( InternetSales_USD[SalesAmount_USD] ),
    PREVIOUSYEAR ( FiscalCalendar )
)

Funções de inteligência de hora funções de data e horaPREVIOUSDAYPREVIOUSWEEKPREVIOUSMONTHPREVIOUSQUARTER