DateTimeFormatInfo.AbbreviatedDayNames 屬性

定義

取得或設定包含特定文化特性之星期縮寫名稱的一維陣列 (型別為 String)。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()

屬性值

String[]

包含特定文化特性之星期縮寫名稱的一維陣列 (型別為 String)。A one-dimensional array of type String containing the culture-specific abbreviated names of the days of the week. InvariantInfo 的陣列包含 "Sun"、"Mon"、"Tue"、"Wed"、"Thu"、"Fri" 和 "Sat"。The array for InvariantInfo contains "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", and "Sat".

例外狀況

此屬性已設定為 nullThe property is being set to null.

正在將屬性設定為多維或長度不是剛好為 7 的陣列。The property is being set to an array that is multidimensional or that has a length that is not exactly 7.

屬性已設定,而且 DateTimeFormatInfo 物件是唯讀的。The property is being set and the DateTimeFormatInfo object is read-only.

範例

下列範例會建立代表英文(美國)文化特性的讀取/寫入 CultureInfo 物件,並將縮寫的日名稱指派給它的 AbbreviatedDayNames 屬性。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. 然後,它會在自訂日期和時間格式字串中使用 "ddd" 格式規範,以顯示日期的字串表示,一周開始5月28日,2014。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

備註

如果設定這個屬性,陣列必須是一維,而且必須正好有七個元素。If setting this property, the array must be one-dimensional and must have exactly seven elements. 第一個專案(位於索引零的元素)代表日曆中一周的第一天,由 Calendar 屬性所定義。The first element (the element at index zero) represents the first day of the week in the calendar defined by the Calendar property.

如果自訂格式字串包含 "ddd" 格式規範,則 DateTime.ToStringToString 方法會包含 AbbreviatedDayNames 陣列的適當成員,以取代結果字串中的 "ddd"。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.

如果 Calendar 屬性的值變更,這個屬性會受到影響。This property is affected if the value of the Calendar property changes. 如果選取的 Calendar 不支援縮寫的日期名稱,陣列就會包含完整的日期名稱。If the selected Calendar does not support abbreviated day names, the array contains the full day names.

適用於

另請參閱