WeekdayName 函式 (Visual Basic)
更新：2007 年 11 月
傳回包含指定星期名稱的 String 值。
Public Function WeekdayName( _ ByVal Weekday As Integer, _ Optional ByVal Abbreviate As Boolean = False, _ Optional ByVal FirstDayOfWeekValue As FirstDayOfWeek = FirstDayOfWeek.System _ ) As String
參數
Weekday
必要項。Integer - 從 1 到 7 的週間日之數值指派；1 表示一週的第一天，7 表示一週的最後一天。第一天和最後一天的識別 (Identity) 需視 FirstDayOfWeekValue 的設定而定。Abbreviate
選擇項。指出星期名稱是否為縮寫的 Boolean 值。如果省略，預設值為 False，表示星期名稱不是縮寫。FirstDayOfWeekValue
選擇項。選自 FirstDayOfWeek 列舉型別的值，指定一週的第一天。如果未指定，就使用 FirstDayOfWeek.System。
設定
FirstDayOfWeekValue 引數可以有下列其中一個設定。
列舉型別值 |
值 |
描述 |
|---|---|---|
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 小於 1 或大於 7，或 FirstDayOfWeekValue 小於 0 或大於 7。 |
如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。
備註
WeekdayName 傳回的字串不只視輸入引數而定，也會取決於 Windows [控制台] 中所指定的 [地區選項] 設定。
.gif "注意事項") 注意事項： |
|---|
WeekdayName 使用 System.Globalization 命名空間中 CultureInfo 類別之 CurrentCulture 屬性目前設定的日曆。預設的 CurrentCulture 值將由 [控制台] 設定決定。 |
範例
下列範例會使用 Weekday 函式從指定日期取得當週的星期幾，然後使用 WeekDayName 函式從其數字取得星期名稱。
Dim oldDate As Date
Dim oldWeekDayName As String
oldDate = #2/12/1969#
oldWeekDayName = WeekdayName(Weekday(oldDate))
' oldWeekDayName now contains "Wednesday".
需求
**模組：**DateAndTime
**組件：**Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)