DATESYTD

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Observação

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

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

Sintaxe

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

Parâmetros

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

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

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 booleana que define uma tabela de coluna única de valores de data/hora.

  Observação

  Restrições em expressões booleanas são descritas no tópico, CALCULATE função.

• 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 é ignorada. Dependendo da localidade, o formato pode ser algo como "m-dd" ou "dd-m".

• 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 em execução' para vendas pela 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 tempoFunções de data e horaDATESMTD funçãoDATESQTD função