Partilhar via


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.

Para entrada de coluna de data, retorna uma tabela que contém uma coluna das datas do ano até a data, no contexto atual.
Para entrada de calendário, retorna uma tabela para o ano até a data, no contexto atual. A tabela contém todas as colunas marcadas primárias e todas as colunas relacionadas ao tempo.

Sintaxe

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

Parâmetros

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

Valor de retorno

Para entrada de coluna de data, uma tabela contendo uma única coluna de valores de data.
Para entrada de calendário, uma tabela que contém todas as colunas marcadas primárias e todas as colunas relacionadas ao tempo.

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

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

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

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

A fórmula de exemplo a seguir cria uma medida que calcula o 'Total em execução' para vendas pela Internet no calendário fiscal.

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

Funções de inteligência de tempo FunçãoDATESWTDDATESMTD função DATESQTDde função de função de data e hora