MonthName, fonction (Visual Basic)

Mise à jour : novembre 2007

Retourne une valeur String contenant le nom du mois spécifié.

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

Paramètres

  • Month
    Requis. Integer. Désignation numérique du mois, entre 1 et 13 ; 1 représente janvier et 12, décembre. Vous pouvez utiliser la valeur 13 avec un calendrier de 13 mois. Si votre système utilise un calendrier de 12 mois et que Month a la valeur 13, MonthName retourne une chaîne vide.

  • Abbreviate
    Facultatif. Valeur Boolean qui indique si le nom du mois doit être abrégé. Si cette valeur est omise, la valeur par défaut est False, ce qui signifie que le nom du mois n'est pas abrégé.

Exceptions

Type d'exception

Numéro de l'erreur

Condition

ArgumentException

5

Month est inférieur à 1 ou supérieur à 13.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La chaîne retournée par MonthName dépend non seulement des arguments d'entrée, mais également des paramètres Options régionales spécifiés dans le Panneau de configuration Windows.

Remarque :

MonthName utilise le paramètre de calendrier actuel de la propriété CurrentCulture de la classe CultureInfo dans l'espace de noms System.Globalization. Les valeurs par défaut de CurrentCulture dépendent des paramètres du Panneau de configuration.

Exemple

Cet exemple utilise la fonction MonthName pour déterminer le nom du mois, en fonction de l'entier spécifié. La valeur Boolean détermine si le nom complet (False) ou abrégé (True) est affiché.

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

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**DateAndTime

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Référence

WeekdayName, fonction (Visual Basic)

System

System.Globalization

DateTime

ArgumentException

CultureInfo