DateTimeFormatInfo.AbbreviatedDayNames Property

Definition

Gets or sets a one-dimensional array of type String containing the culture-specific abbreviated names of the days of the week.

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

Property Value

String[]

A one-dimensional array of type String containing the culture-specific abbreviated names of the days of the week. The array for InvariantInfo contains "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", and "Sat".

Exceptions

The property is being set to null.

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

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 day names to its AbbreviatedDayNames property. It then uses the "ddd" format specifier in a custom date and time format string to display the string representation of dates for one week beginning May 28, 2014.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo ci = CultureInfo.CreateSpecificCulture("en-US");
      DateTimeFormatInfo dtfi = ci.DateTimeFormat;
      dtfi.AbbreviatedDayNames = new String[] { "Su", "M", "Tu", "W",
                                                "Th", "F", "Sa" };
      DateTime dat = new DateTime(2014, 5, 28);

      for (int ctr = 0; ctr <= 6; ctr++) {
         String output = String.Format(ci, "{0:ddd MMM dd, yyyy}", dat.AddDays(ctr));
         Console.WriteLine(output);
      }
   }
}
// The example displays the following output:
//       W May 28, 2014
//       Th May 29, 2014
//       F May 30, 2014
//       Sa May 31, 2014
//       Su Jun 01, 2014
//       M Jun 02, 2014
//       Tu Jun 03, 2014
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim ci As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
      Dim dtfi As DateTimeFormatInfo = ci.DateTimeFormat
      dtfi.AbbreviatedDayNames = { "Su", "M", "Tu", "W", "Th",  
                                   "F", "Sa" }  
      Dim dat As Date = #05/28/2014#

      For ctr As Integer = 0 To 6 
         Dim output As String = String.Format(ci, "{0:ddd MMM dd, yyyy}", dat.AddDays(ctr))
         Console.WriteLine(output)
      Next 
   End Sub 
End Module 
' The example displays the following output:
'       W May 28, 2014
'       Th May 29, 2014
'       F May 30, 2014
'       Sa May 31, 2014
'       Su Jun 01, 2014
'       M Jun 02, 2014
'       Tu Jun 03, 2014

Remarks

If setting this property, the array must be one-dimensional and must have exactly seven elements. The first element (the element at index zero) represents the first day of the week in the calendar defined by the Calendar property.

If a custom format string includes the "ddd" format specifier, the DateTime.ToString or ToString method includes the appropriate member of the AbbreviatedDayNames array in place of the "ddd" in the result string.

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

Applies to

See also