Mostrar tudo

Ocultar tudo

Devolve uma Variante (Número Inteiro) que especifica um número inteiro entre 1 e 12, inclusive, que representa o mês do ano.

Sintaxe

Mês(data)

O argumento (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.) data obrigatório é qualquer Variante (tipo de dados Variante: tipo de dados predefinido para variáveis que não possuem caracteres de declaração de tipo quando uma instrução do tipo Def não está em vigor. Uma Variante pode armazenar dados numéricos, de cadeia, de data/hora, Nulo ou Vazio.), expressão numérica (expressão numérica: qualquer expressão que possa gerar um número. A expressão pode ser qualquer combinação de variáveis, constantes, funções e operadores.), expressão da cadeia (expressão de cadeia: expressão que equivale a uma sequência de caracteres contíguos. Os elementos da expressão podem ser: funções que devolvem uma cadeia ou uma Variante de cadeia (VarType 8); uma cadeia literal, uma constante, uma variável ou Variante.) ou qualquer combinação destes que represente uma data. Se a data incluir um valor Nulo (Null: valor que pode introduzir num campo ou utilizar em expressões ou consultas para indicar dados em falta ou desconhecidos. No Visual Basic, a palavra-chave Null indica um valor nulo (Null). Alguns campos, tais como campos de chave primária, não podem conter um valor Null.), é devolvido um valor Nulo.

 Nota   Se a definição da propriedade Calendário for Gregoriano, o número inteiro devolvido representa o dia da semana Gregoriano para o argumento data. Se o calendário for Hijri, o número inteiro devolvido representa o dia da semana Hijri para o argumento data. Em datas Hijri, o número do argumento é qualquer expressão numérica que represente uma data e/ou hora de 1/1/100 (2 de Ago de 718, Gregoriano) a 3/4/9666 (31 de Dez de 9999, Gregoriano).

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.

Este exemplo utiliza a função Mês para obter o mês a partir de uma data especificada. No ambiente de desenvolvimento, o literal da data é apresentado em formato de data abreviado utilizando as definições regionais do código.

Dim MinhaData, MeuMês
MinhaData = #12 de Fevereiro, 1969#    ' Atribuir uma data.
MeuMês = Mês(MinhaData)    ' MeuMês contém 2.