Compartilhar via


STARTOFMONTH

aplica-se a:coluna calculadatabela calculadamedidacálculo visual

Observação

Essa função não é recomendada para uso em cálculos visuais, pois é provável que ela retorne resultados sem sentido.

Para a entrada da coluna de data, retorna a primeira data do mês no contexto atual para a coluna de datas especificada.
Para entrada de calendário, retorna uma tabela para a primeira data do mês, no contexto atual. Uma tabela que contém todas as colunas marcadas primárias e colunas relacionadas a todos os tempos.

Sintaxe

STARTOFMONTH(<dates> or <calendar>)

Parâmetros

Termo Definição
dates or calendar Uma coluna que contém datas ou uma referência de calendário

Valor de retorno

Para entrada de coluna de data, uma tabela que contém uma única coluna e uma única linha com um valor 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.

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

  • 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 retorna o início do mês para o contexto atual.

= STARTOFMONTH(DateTime[DateKey])

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

A fórmula de exemplo a seguir cria uma tabela que retorna colunas primárias marcadas que correspondem ao início do mês, para o calendário fiscal.

= STARTOFMONTH(FiscalCalendar)

Funções de data e horafunções de inteligência de tempoSTARTOFYEARSTARTOFQUARTERSTARTOFWEEK