Partilhar via


Função EOMONTH

Retorna a data no formato datetime do último dia do mês, antes ou depois de um número de meses especificado. Use EOMONTH para calcular datas de vencimento ou datas de conclusão que caem no último dia do mês.

Sintaxe

EOMONTH(<start_date>, <months>)

Parâmetros

Termo

Definição

start_date

A data de início no formato datetime ou em uma representação de texto aceita de uma data.

months

Um número que representa o número de meses antes ou depois de start_date.

ObservaçãoObservação

Se você inserir um número que não seja um inteiro, o número será arredondado para cima ou para baixo até o inteiro mais próximo.

Valor de retorno

Uma data (datetime).

Comentários

Em contraste com o Microsoft Excel, que armazena datas como números de série sequenciais, o DAX trabalha com datas em um formato datetime. A função EOMONTH pode aceitar datas em outros formatos, com as seguintes restrições:

Se start_date não for uma data válida, EOMONTH retornará um erro.

Se start_date for um valor numérico que não está em um formato datetime, EOMONTH converterá o número em uma data. Para evitar resultados inesperados, converta o número em um formato datetime antes de usar a função EOMONTH.

Se start_date mais meses gerar uma data inválida, EOMONTH retornará um erro. Datas anteriores a 1 de março de 1900 e depois de 31 de dezembro de 9999 são inválidas.

Quando o argumento de data for uma representação de texto da data, a função EDATE usará as configurações de localidade e data/hora, do computador cliente, para compreender o valor de texto a fim de executar a conversão. Se as configurações de data/hora atuais representarem uma data no formato Mês/Dia/Ano, a cadeia de caracteres "1/8/2009" a seguir será interpretada como um valor datetime equivalente a 8 de janeiro de 2009. Entretanto, se as configurações de data/hora atuais representarem uma data no formato Dia/Mês/Ano, a mesma cadeia de caracteres será interpretada como um valor datetime equivalente a 1 de agosto de 2009.

Esta função DAX pode retornar resultados diferentes quando usada em um modelo que é implantado e consultado no modo DirectQuery. Para obter mais informações sobre diferenças semânticas no modo DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219171.

Exemplo

A expressão a seguir retorna 31 de maio de 2008, pois o argumento months é arredondado para 2.

=EOMONTH("March 3, 2008",1.5)

Consulte também

Referência

Função EDATE

Outros recursos

Funções de data e hora (DAX)