DateAndTime.Weekday 方法

傳回 Integer 值，包含一個表示星期幾的數字。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function Weekday ( _
    DateValue As DateTime, _
    <OptionalAttribute> Optional DayOfWeek As FirstDayOfWeek = FirstDayOfWeek.Sunday _
) As Integer
'用途
Dim DateValue As DateTime
Dim DayOfWeek As FirstDayOfWeek
Dim returnValue As Integer

returnValue = DateAndTime.Weekday(DateValue, DayOfWeek)

public static int Weekday (
    DateTime DateValue,
    [OptionalAttribute] FirstDayOfWeek DayOfWeek
)

public:
static int Weekday (
    DateTime DateValue, 
    [OptionalAttribute] FirstDayOfWeek DayOfWeek
)

public static int Weekday (
    DateTime DateValue, 
    /** @attribute OptionalAttribute() */ FirstDayOfWeek DayOfWeek
)

public static function Weekday (
    DateValue : DateTime, 
    DayOfWeek : FirstDayOfWeek
) : int

參數

• DateValue
  必要項。您想用來判斷星期幾的 Date 值。

• DayOfWeek
  選擇項。選自 FirstDayOfWeek 列舉型別的值，指定一週的第一天。如果未指定，就會使用 FirstDayOfWeek.Sunday。

傳回值

傳回 Integer 值，包含一個表示星期幾的數字。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 Weekday 函式 (Visual Basic)。

Weekday 函式傳回的值會對應到 FirstDayOfWeek 列舉型別的值，也就是說，1 表示星期日，7 表示星期六。

注意事項
Weekday 會使用 (System.Globalization 命名空間中) CultureInfo 類別之 CurrentCulture 屬性的目前月曆設定。預設的 CurrentCulture 值將由 [控制台] 設定決定。

DayOfWeek 引數可以是下列設定之一。

列舉值	值	描述
FirstDayOfWeek.System	0	系統設定中指定之一週的第一天
FirstDayOfWeek.Sunday	1	星期日 (預設值)
FirstDayOfWeek.Monday	2	星期一 (符合 ISO 標準 8601 的第 3.17 節)
FirstDayOfWeek.Tuesday	3	星期二
FirstDayOfWeek.Wednesday	4	星期三
FirstDayOfWeek.Thursday	5	星期四
FirstDayOfWeek.Friday	6	星期五
FirstDayOfWeek.Saturday	7	星期六

範例

下列範例會使用 Weekday 函式，從指定之日期取得星期幾。

Dim oldDate As Date
Dim oldWeekDay As Integer
oldDate = #2/12/1969#
oldWeekDay = Weekday(oldDate)
' oldWeekDay now contains 4 because thisDate represents a Wednesday.

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

DateAndTime 類別
DateAndTime 成員
Microsoft.VisualBasic 命名空間
DateTime

其他資源

Weekday 函式 (Visual Basic)
Day 函式 (Visual Basic)
Month 函式 (Visual Basic)
Now 屬性
WeekdayName 函式 (Visual Basic)
Year 函式 (Visual Basic)
DatePart 函式 (Visual Basic)