แก้ไข

แชร์ผ่าน


DateTimeFormatInfo.AbbreviatedMonthGenitiveNames Property

Definition

Gets or sets a string array of abbreviated month names associated with the current DateTimeFormatInfo object.

public:
 property cli::array <System::String ^> ^ AbbreviatedMonthGenitiveNames { cli::array <System::String ^> ^ get(); void set(cli::array <System::String ^> ^ value); };
public string[] AbbreviatedMonthGenitiveNames { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public string[] AbbreviatedMonthGenitiveNames { get; set; }
member this.AbbreviatedMonthGenitiveNames : string[] with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.AbbreviatedMonthGenitiveNames : string[] with get, set
Public Property AbbreviatedMonthGenitiveNames As String()

Property Value

String[]

An array of abbreviated month names.

Attributes

Exceptions

In a set operation, the array is multidimensional or has a length that is not exactly 13.

In a set operation, the array or one of the elements of the array is null.

In a set operation, the current 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 month 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

In some languages, a month name that is part of a date appears in the genitive case. For example, a date in the ru-RU or Russian (Russia) culture consists of the day number and the genitive month name, such as 1 Января (1 January). For these cultures, if a custom format string includes the "MMM" format specifier, the DateTime.ToString or ToString method includes the appropriate member of the AbbreviatedMonthGenitiveNames array in place of the "MMM" in the result string.

In a set operation, the array must be one-dimensional with exactly 13 elements, because Calendar objects accommodate calendars that have 13 months. For calendars that have 12 months, the thirteenth element should be String.Empty. The first element (the element at index zero) represents the first month of the year defined by the Calendar property.

If you set the AbbreviatedMonthGenitiveNames property, you must also set the AbbreviatedMonthNames property.

Applies to

See also