DateTimeFormatInfo.AbbreviatedMonthNames Property

Reference

Definition

Namespace:: System.Globalization

Assembly:: System.Globalization.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: DateTimeFormatInfo.cs

Source:: DateTimeFormatInfo.cs

Source:: DateTimeFormatInfo.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a one-dimensional string array that contains the culture-specific abbreviated names of the months.

public:
 property cli::array <System::String ^> ^ AbbreviatedMonthNames { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };

public string[] AbbreviatedMonthNames { get; set; }

member this.AbbreviatedMonthNames : string[] with get, set

Public Property AbbreviatedMonthNames As String()

Property Value

String[]

A one-dimensional string array with 13 elements that contains the culture-specific abbreviated names of the months. For 12-month calendars, the 13th element of the array is an empty string. The array for InvariantInfo contains "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec", and "".

Exceptions

ArgumentNullException

The property is being set to null.

ArgumentException

The property is being set to an array that is multidimensional or that has a length that is not exactly 13.

InvalidOperationException

The property is being set and the DateTimeFormatInfo object is read-only.

Examples

The following example creates a read/write CultureInfo object that represents the English (United States) culture and assigns abbreviated genitive month names to its AbbreviatedMonthNames and AbbreviatedMonthGenitiveNames properties. It then displays the string representation of dates that include the abbreviated name of each month in the culture's supported calendar.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo ci = CultureInfo.CreateSpecificCulture("en-US");
      DateTimeFormatInfo dtfi = ci.DateTimeFormat;
      dtfi.AbbreviatedMonthNames = new string[] { "of Jan", "of Feb", "of Mar",
                                                  "of Apr", "of May", "of Jun",
                                                  "of Jul", "of Aug", "of Sep",
                                                  "of Oct", "of Nov", "of Dec", "" };
      dtfi.AbbreviatedMonthGenitiveNames = dtfi.AbbreviatedMonthNames;
      DateTime dat = new DateTime(2012, 5, 28);

      for (int ctr = 0; ctr < dtfi.Calendar.GetMonthsInYear(dat.Year); ctr++)
         Console.WriteLine(dat.AddMonths(ctr).ToString("dd MMM yyyy", dtfi));
   }
}
// The example displays the following output:
//       28 of May 2012
//       28 of Jun 2012
//       28 of Jul 2012
//       28 of Aug 2012
//       28 of Sep 2012
//       28 of Oct 2012
//       28 of Nov 2012
//       28 of Dec 2012
//       28 of Jan 2013
//       28 of Feb 2013
//       28 of Mar 2013
//       28 of Apr 2013

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim ci As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
      Dim dtfi As DateTimeFormatInfo = ci.DateTimeFormat
      dtfi.AbbreviatedMonthNames = { "of Jan", "of Feb", "of Mar", 
                                     "of Apr", "of May", "of Jun", 
                                     "of Jul", "of Aug", "of Sep", 
                                     "of Oct", "of Nov", "of Dec", "" }  
      dtfi.AbbreviatedMonthGenitiveNames = dtfi.AbbreviatedMonthNames
      Dim dat As Date = #05/28/2012#
      
      For ctr As Integer = 0 To dtfi.Calendar.GetMonthsInYear(dat.Year) - 1
         Console.WriteLine(dat.AddMonths(ctr).ToString("dd MMM yyyy", dtfi))
      Next
   End Sub
End Module
' The example displays the following output:
'       28 of May 2012
'       28 of Jun 2012
'       28 of Jul 2012
'       28 of Aug 2012
'       28 of Sep 2012
'       28 of Oct 2012
'       28 of Nov 2012
'       28 of Dec 2012
'       28 of Jan 2013
'       28 of Feb 2013
'       28 of Mar 2013
'       28 of Apr 2013

Remarks

If you set this property, the array must be one-dimensional with exactly 13 elements. Calendar objects accommodate calendars with 13 months. The first element (the element at index zero) represents the first month of the year defined by the Calendar property.

If you set the AbbreviatedMonthNames property, you must also set the AbbreviatedMonthGenitiveNames property. The AbbreviatedMonthNames and AbbreviatedMonthGenitiveNames properties are used to format dates using the following format strings:

A standard date and time format string that aliases a custom format string that includes the "MMM" format specifier.
A custom date and time format string that includes the "MMM" format specifier.

This property is affected if the value of the Calendar property changes. If the selected Calendar does not support abbreviated month names, the array contains the full month names.

Applies to

Share via