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:   mscorlib (in mscorlib.dll)
  System.Globalization (in System.Globalization.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.5.3, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft