DATESYTD

  • Artigo

Retorna uma tabela que contém uma coluna das datas do ano até a data, no contexto atual.

Sintaxe

DATESYTD(<dates> [,<year_end_date>])

Parâmetros

Termo Definição
datas Uma coluna que contém datas.
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.

Retornar valor

Uma tabela que contém uma única coluna de valores de data.

Comentários

O argumento dates pode ser 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.

    Observação

    As restrições em expressões boolianas são descritas no tópico função CALCULATE.

  • O parâmetro year_end_date é um literal de cadeia de caracteres de uma data, na mesma localidade que a usada pelo cliente em que a pasta de trabalho foi criada. A parte de ano da data é ignorada. Dependendo da localidade, o formato pode ser algo como "m-dd" ou "dd-m".

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplo

A fórmula de exemplo a seguir cria uma medida que calcula o 'Total Dinâmico' para Vendas na Internet.

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

A fórmula de exemplo a seguir cria uma medida que calcula o "Total de Execução do Ano Fiscal" para vendas pela Internet, usando uma Localidade dos EUA para o formato Data.

= CALCULATE(
    SUM(InternetSales_USD[SalesAmount_USD]), 
    DATESYTD(DateTime[DateKey],
        "6-30"
        )
)

Conteúdo relacionado

Funções de inteligência de dados temporais
Funções de data e hora
função DATESMTD
função DATESQTD