Função STARTOFYEAR

Artigo
09/10/2013

Retorna a primeira data do ano no contexto atual para a coluna de datas especificada.

Sintaxe

STARTOFYEAR(<dates>)

Parâmetros

Termo	Definição
dates	Uma coluna que contém datas.
YearEndDate	(Opcional) Um valor de data de fim de ano.

Valor de retorno

Uma tabela que contém uma única coluna e linha com um valor de data.

Comentários

Observação
Para entender melhor como o contexto afeta os resultados das fórmulas, consulte Contexto em fórmulas DAX.

O argumento dates pode ser qualquer um destes:

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 com uma única coluna de valores de data/hora.

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

Esta função DAX não tem suporte para uso no modo DirectQuery. Para obter mais informações sobre limitações nos modelos DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219172.

Exemplo

A fórmula de exemplo a seguir cria uma medida que retorna o início do ano para o contexto atual.

Para ver como isso funciona, crie uma Tabela Dinâmica e adicione os campos CalendarYear e MonthNumberOfYear à área Rótulos de Linha da Tabela Dinâmica. Em seguida, adicione uma medida denominada StartOfYear, usando a fórmula definida na seção de código, à área Valores da Tabela Dinâmica.