Export (0) Print
Expand All

DateTimeFormatInfo.AbbreviatedDayNames Property

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

Namespace:  System.Globalization
Assemblies:   System.Globalization (in System.Globalization.dll)
  mscorlib (in mscorlib.dll)

public string[] AbbreviatedDayNames { get; set; }

Property Value

Type: System.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".

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

InvalidOperationException

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

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.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft