Função MonthName (Visual Basic)

Artigo
08/25/2010

Retorna um valor String contendo o nome do mês especificado.

Public Function MonthName( _
   ByVal Month As Integer, _
   Optional ByVal Abbreviate As Boolean = False _
) As String

Parâmetros

Month
Obrigatório.Integer.A designação numérica do mês, de 1 a 13; 1 indica janeiro e 12 indica dezembro.Você pode usar o valor 13 com um calendário de 13 meses.Se seu sistema estiver usando um calendário de 12 meses e Month ser 13, MonthName retorna uma cadeia de caracteres vazia.
Abbreviate
Opcional.Boolean valor que indica se o nome do mês deve ser abreviado. Se omitido, o padrão é False, o que significa que o nome do mês não está abreviado.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Month é menor que 1 ou maior que 13.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

A cadeia de caracteres retornada por MonthName depende não somente dos argumentos de entrada, mas também das configurações Opções Regionais especificadas no Painel de Controle do Windows.

Observação:
MonthName utiliza a configuração atual de calendário da propriedade CurrentCulture da classe CultureInfo no namespace System.Globalization.Os valores CurrentCulture padrão são determinados por configurações do Painel de Controle.

Exemplo

Este exemplo usa a função MonthName para determinar o nome do mês pelo número inteiro dado.O valor Boolean determinará se o nome completo (False) ou o nome abreviado (True) será exibido.

Dim thisMonth As Integer
Dim name As String
thisMonth = 4
' Set Abbreviate to True to return an abbreviated name.
name = MonthName(thisMonth, True)
' name now contains "Apr".