Compartilhar via


Função MONTH (DAX)

Retorna o mês como um número de 1 (janeiro) a 12 (dezembro).

Sintaxe

MONTH(<datetime>)

Parâmetros

Termo

Definição

date

Uma data no formato datetime ou no formato de texto.

Valor de retorno

Um número inteiro de 1 a 12.

Comentários

Em comparação com o Microsoft Excel, que armazena datas como números de série, o DAX usa um formato datetime ao trabalhar com datas. Você pode inserir a data usada como argumento na função MONTH, digitando um formato datetime aceito, fornecendo uma referência a uma coluna que contém datas, ou usando uma expressão que retorna uma data.

Valores retornados pelas funções YEAR, MONTH e DAY serão valores do calendário gregoriano, seja qual for o formato de exibição do valor de data fornecido. Por exemplo, se o formato de exibição da data fornecida for Hijri, os valores retornados para as funções YEAR, MONTH e DAY serão valores associados à data equivalente no calendário gregoriano.

Quando o argumento de data for uma representação de texto da data, a função 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, e a função gerará um resultado de valor 1. 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, e a função gerará um resultado de valor 8.

Se não for possível converter corretamente a representação de texto da data em um valor datetime, a função retornará um erro.

Exemplo

A expressão a seguir retorna 3, que é o inteiro correspondente a março, o mês no argumento date.

=MONTH("March 3, 2008 3:45 PM")

A expressão a seguir retorna o mês da data na coluna TransactionDate da tabela Orders.

=MONTH(Orders[TransactionDate])