DateAndTime.MonthName Method (Int32, Boolean)

 

Returns a String value containing the name of the specified month.

Namespace:   Microsoft.VisualBasic
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

public static string MonthName(
	int Month,
	bool Abbreviate = false
)

Parameters

Month
Type: System.Int32

Required. Integer. The numeric designation of the month, from 1 through 13; 1 indicates January and 12 indicates December. You can use the value 13 with a 13-month calendar. If your system is using a 12-month calendar and Month is 13, MonthName returns an empty string.

Abbreviate
Type: System.Boolean

Optional. Boolean value that indicates if the month name is to be abbreviated. If omitted, the default is False, which means the month name is not abbreviated.

Return Value

Type: System.String

Returns a String value containing the name of the specified month.

Exception Condition
ArgumentException

Month is less than 1 or greater than 13.

The string returned by MonthName depends not only on the input arguments, but also on the Regional Options settings specified in the Windows Control Panel.

System_CAPS_noteNote

MonthName uses the current calendar setting from the CurrentCulture property of the CultureInfo class in the System.Globalization namespace. The default CurrentCulture values are determined by Control Panel settings.

This example uses the MonthName function to determine the name of the month, by the integer given. The Boolean value will determine whether the full name (False) or the abbreviated name (True) will be displayed.

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

.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Return to top
Show: