DateTimeOffset.DayOfWeek 属性

定义

获取由当前 DateTimeOffset 对象所表示的周中的某一天。Gets the day of the week represented by the current DateTimeOffset object.

public:
 property DayOfWeek DayOfWeek { DayOfWeek get(); };
public DayOfWeek DayOfWeek { get; }
member this.DayOfWeek : DayOfWeek
Public ReadOnly Property DayOfWeek As DayOfWeek

属性值

用于指示当前 DateTimeOffset 对象的星期几的枚举值之一。One of the enumeration values that indicates the day of the week of the current DateTimeOffset object.

示例

下面的示例显示2008年每个月的第一天的星期几名称。The following example displays the weekday name of the first day of each month of the year 2008.

DateTimeOffset startOfMonth = new DateTimeOffset(2008, 1, 1, 0, 0, 0, 
                                         DateTimeOffset.Now.Offset);
int year = startOfMonth.Year;
do 
{
   Console.WriteLine("{0:MMM d, yyyy} is a {1}.", startOfMonth, startOfMonth.DayOfWeek);
   startOfMonth = startOfMonth.AddMonths(1);
}
while (startOfMonth.Year == year);
// This example writes the following output to the console:
//    Jan 1, 2008 is a Tuesday.
//    Feb 1, 2008 is a Friday.
//    Mar 1, 2008 is a Saturday.
//    Apr 1, 2008 is a Tuesday.
//    May 1, 2008 is a Thursday.
//    Jun 1, 2008 is a Sunday.
//    Jul 1, 2008 is a Tuesday.
//    Aug 1, 2008 is a Friday.
//    Sep 1, 2008 is a Monday.
//    Oct 1, 2008 is a Wednesday.
//    Nov 1, 2008 is a Saturday.
//    Dec 1, 2008 is a Monday.      
Dim startOfMonth As New DateTimeOffset(#1/1/2008#, _
                                      DateTimeOffset.Now.Offset)
Dim year As Integer = startOfMonth.Year
Do While startOfMonth.Year = year
   Console.WriteLine("{0:MMM d, yyyy} is a {1}.", _
                     startOfMonth, startOfMonth.DayOfWeek)
   startOfMonth = startOfMonth.AddMonths(1)                   
Loop      
' This example writes the following output to the console:
'    Jan 1, 2008 is a Tuesday.
'    Feb 1, 2008 is a Friday.
'    Mar 1, 2008 is a Saturday.
'    Apr 1, 2008 is a Tuesday.
'    May 1, 2008 is a Thursday.
'    Jun 1, 2008 is a Sunday.
'    Jul 1, 2008 is a Tuesday.
'    Aug 1, 2008 is a Friday.
'    Sep 1, 2008 is a Monday.
'    Oct 1, 2008 is a Wednesday.
'    Nov 1, 2008 is a Saturday.
'    Dec 1, 2008 is a Monday.      

注解

DayOfWeek 枚举中的常量的值范围是从 DayOfWeek.SundayDayOfWeek.SaturdayThe value of the constants in the DayOfWeek enumeration ranges from DayOfWeek.Sunday to DayOfWeek.Saturday. 如果强制转换为整数,则其值范围为0(指示 DayOfWeek.Sunday)到6(表示 DayOfWeek.Saturday)。If cast to an integer, its value ranges from zero (which indicates DayOfWeek.Sunday) to six (which indicates DayOfWeek.Saturday).

还可以通过使用 "D" 格式说明符或 "dddd" 自定义格式说明符来显示特定日期的星期几名称。You can also display the weekday name of a particular date by using the "D" format specifier or the "dddd" custom format specifier. 例如:For example:

DateTimeOffset displayDate = new DateTimeOffset(2008, 1, 1, 13, 18, 00, 
                                                DateTimeOffset.Now.Offset);
Console.WriteLine("{0:D}", displayDate);  // Output: Tuesday, January 01, 2008                     
Console.WriteLine("{0:d} is a {0:dddd}.", 
                  displayDate);           // Output: 1/1/2008 is a Tuesday.
Dim displayDate As New DateTimeOffset(#1/1/2008 1:18PM#, _
                                      DateTimeOffset.Now.Offset)
Console.WriteLine("{0:D}", displayDate)    ' Output: Tuesday, January 01, 2008                     
Console.WriteLine("{0:d} is a {0:dddd}.", _
                  displayDate)             ' Output: 1/1/2008 is a Tuesday.

请注意,通过调用此属性返回的 DayOfWeek 枚举成员的 ToString 方法返回的字符串未进行本地化。Note that the string returned by calling the ToString method of the DayOfWeek enumeration member that is returned by this property is not localized. 若要提取包含当前区域性或特定区域性的星期几名称的字符串,请使用 "dddd" 自定义格式说明符调用 ToString 方法。To extract a string that contains the weekday name of the current culture or of a specific culture, call the ToString method with the "dddd" custom format specifier. 例如,下面的代码使用 fr-fr 区域性显示日期的星期几名称。For example, the following code displays the weekday name for a date using the fr-fr culture.

DateTimeOffset thisDate = new DateTimeOffset(2007, 6, 1, 6, 15, 0, 
                                             DateTimeOffset.Now.Offset);
string weekdayName = thisDate.ToString("dddd", 
                                       new CultureInfo("fr-fr")); 
Console.WriteLine(weekdayName);                  // Displays vendredi     
Dim thisDate As New DateTimeOffset(#6/1/2007 6:15AM#, _
                                      DateTimeOffset.Now.Offset)
Dim weekdayName As String = thisDate.ToString("dddd", _
                            New CultureInfo("fr-fr")) 
Console.WriteLine(weekdayName)                        ' Displays vendredi     

适用于