Histórico da Página

Sintaxe

MONTH( <expressão data> )

Propósito

Extrai o número do mês de uma determinada data.

Argumentos

<expressão data>

Define a data da qual se extrairá o número do mês.

Utilização

A função MONTH() opera sobre dados do tipo data, fornecendo o valor numérico que representa o mês da data em questão.

A expressão data pode ser uma variável tipo data, um campo tipo data, uma expressão envolvendo datas, a data do sistema operacional, fornecida pela função DATE(), ou a data do sistema Protheus, fornecida pela variável dDataBase.

Se a expressão data especificada resultar em uma data nula ou vazia, será fornecido o valor zero.

Dicas

A função MONTH() é muito útil para aplicações que possuam cálculos com os meses de datas.

A função CMONTH() é semelhante à função MONTH(), só que fornece os nomes dos meses ao invés do seu número.

A função MONTH() também está relacionada com as funções DAY() e YEAR(), que fornece, respectivamente, o dia e o ano de uma data.

Exemplos

MsgAlert( DATE() )          // Resulta 28/03/12

MsgAlert( MONTH(DATE()) )          // Resulta o valor numérico 3

dData := CTOD(“19/12/90”)

MsgAlert( MONTH(dData) )            // Resulta o valor numérico 12

nMes := MONTH(dData)

MsgAlert( nMes)                             // Resulta o valor numérico 12