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 値で定義された曜日を週の第 1 日目とする DateValue の曜日を表す値です。たとえば、週の第 1 日目が月曜日として指定されているとき、日付が水曜日に該当する場合は 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.
必要条件
名前空間 : Microsoft.VisualBasic
**モジュール :**DateAndTime
**アセンブリ :**Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll)