Compartilhar via


Função MonthName (Visual Basic)

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".

Requisitos

Namespace: Microsoft.VisualBasic

**Módulo:**DateAndTime

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Função WeekdayName (Visual Basic)

System

System.Globalization

DateTime

ArgumentException

CultureInfo