Weekday 函式 (Visual Basic)
更新：2007 年 11 月
傳回包含表示週中星期幾的 Integer 值。
Public Function Weekday( _
ByVal DateValue As DateTime, _
Optional ByVal DayOfWeek As FirstDayOfWeek = FirstDayOfWeek.Sunday _
) As Integer
參數
DateValue
必要項。您希望判斷週中星期幾的 Date 值。DayOfWeek
選擇項。選自 FirstDayOfWeek 列舉型別的值，指定一週的第一天。如果未指定，就使用 FirstDayOfWeek.Sunday。
設定
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 |
星期六 |
例外狀況
例外狀況類型 |
錯誤代碼 |
條件 |
|---|---|---|
DayOfWeek 小於 0 或大於 7。 |
如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。
備註
Weekday 函式的傳回值是一週中的第幾天，它是指相對於 DayOfWeek 值所定義之一週的第一天，DateValue 對應到一週中的第幾天。例如，如果日期是星期三，而一週的第一天指定為星期一，則函式會傳回 3。
.gif "注意事項") 注意事項： |
|---|
Weekday 使用 System.Globalization 命名空間中 CultureInfo 類別之 CurrentCulture 屬性目前設定的日曆。預設的 CurrentCulture 值將由 [控制台] 設定決定。 |
範例
下列範例會使用 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.
需求
**模組：**DateAndTime
**組件：**Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)