MONTH

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

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

Sintaxe

MONTH(<datetime>)  

Parâmetros

Termo	Definição
data	Uma data em datetime ou em formato de texto.

Valor retornado

Um número inteiro de 1 a 12.

Comentários

• Ao contrário do Microsoft Excel, que armazena datas como números de série, o DAX usa o formato datetime ao trabalhar com datas. Você pode inserir a data usada como argumento para a função MONTH digitando um formato datetime aceito, fornecendo uma referência a uma coluna que contenha datas ou usando uma expressão que retorna uma data.

• Os valores retornados pelas funções YEAR, MONTH e DAY serão valores gregorianos, independentemente do 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 gregoriana equivalente.

• Quando o argumento de data é uma representação de texto da data, a função usa as configurações de localidade e de data e hora do computador cliente para reconhecer o valor de texto a fim de fazer a conversão. Se as configurações atuais de data/hora representarem uma data no formato de Mês/Dia/Ano, a cadeia de caracteres a seguir "1/8/2009" será interpretada como valor de datetime equivalente a 8 de janeiro de 2009 e a função retornará 1. No entanto, se as configurações atuais de data/hora representarem uma data no formato de 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 retornará 8.

• Se a representação de texto da data não puder ser convertida corretamente em um valor datetime, a função retornará um erro.

Exemplo 1

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

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

Exemplo 2

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

= MONTH(Orders[TransactionDate])  

Conteúdo relacionado

Funções de data e hora
Função HOUR
Função MINUTE
função YEAR
função SECOND