何曜日であるかを表す整数をバリアント型 (内部処理形式 Integer の Variant) で返します。
構文
Weekday(date [, firstdayofweek ] )
Weekday 関数構文の引数は次のとおりです。
| 引数 | 説明 |
|---|---|
| 日付 | 必ず指定します。 バリアント型、数値式、文字列式、または日付を表すことができる任意の組み合わせ。 date に Null が含まれている場合、Null が返されます。 |
| firstdayofweek | 省略可能です。 週の最初の日を指定する定数。 省略すると、vbSunday と見なされます。 |
設定
firstdayofweek 引数には、次の設定があります。
| 定数 | 値 | 説明 |
|---|---|---|
| vbUseSystem | 0 | NLS API の設定を使います。 |
| vbSunday | 1 | 日曜日 (既定) |
| vbMonday | 2 | 月曜日 |
| vbTuesday | 3 | 火曜日 |
| vbWednesday | 4 | 水曜日 |
| vbThursday | 5 | 木曜日 |
| vbFriday | 6 | 金曜日 |
| vbSaturday | 7 | 土曜日 |
戻り値
Weekday 関数は次のいずれかの値を返します。
| 定数 | 値 | 説明 |
|---|---|---|
| vbSunday | 1 | 日曜日 |
| vbMonday | 2 | 月曜日 |
| vbTuesday | 3 | 火曜日 |
| vbWednesday | 4 | 水曜日 |
| vbThursday | 5 | 木曜日 |
| vbFriday | 6 | 金曜日 |
| vbSaturday | 7 | 土曜日 |
解説
[予定表] のプロパティ設定がグレゴリオ暦の場合、返される整数は、date 引数のグレゴリオ暦の曜日を示します。 [予定表] がイスラム暦の場合、返される整数は、date 引数のイスラム暦の曜日を示します。 イスラム暦の場合、引数の数は、1/1/100 (グレゴリア暦 718 年 8 月 2 日) から 4/3/9666 (グレゴリア暦 9999 年 12 月 31 日) までを示す任意の数値式です。
クエリの例
| Expression | 結果 |
|---|---|
| SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales; | フィールド "DateofSale" から値と、これらの日付値の 'Weekday' を表す数値を返します。 (既定では、日曜日は週の最初の日と見なされます。1)。 |
| SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales; | フィールド "DateofSale" から値と、これらの日付値の 'Weekday' を表す数値を返します。 (月曜日を週の最初の日と考える)。 |
VBA の例
注
次の例は、Visual Basic for Applications (VBA) モジュールでのこの関数の使用方法を示しています。 VBA の使用方法の詳細については、[検索] の横にあるドロップダウン リストで [開発者用リファレンス] を選び、検索ボックスに検索する用語を入力します。
この例では、Weekday 関数を使用して、指定した日付から曜日を取得します。
Dim MyDate, MyWeekDay
MyDate = #February 12, 1969# ' Assign a date.
MyWeekDay = Weekday(MyDate)
' MyWeekDay contains 4 because
' MyDate represents a Wednesday.