本ページには広告が含まれています。
引数で指定した曜日番号に対応する曜日名を返します。
日付から曜日番号を取得するgetWeekday関数 (自作関数)と組み合わせて使用します。
- 構文
- UString = getWeekdayName( weekday, abbreviate, firstdayofweek )
- 引数
- weekday (Integer)必須
- 曜日を表す1から7の数値。1は週の最初の曜日、7は週の最後の曜日を示しています。この値はfirstdayofweekの値に依存します。
- abbreviate (Boolean = False)省略可
- 曜日名を省略するかを示すブール値。
- firstdayofweek (Integer = 1)省略可
- 週の始まりの曜日を指定。省略した場合は、日曜日が1から始まる値を使用。
- 戻り値
- 曜日番号に対応する曜日名
プログラム
週開始曜日
以下は曜日(weekday)と週開始曜日(firstdayofweek)の関係を示した表です。
曜日と週開始曜日の交差する点の値が返ります。
| 週開始曜日 (firstdayofweek) | 曜日(weekday) | ||||||
|---|---|---|---|---|---|---|---|
| 1 | 2 | 3 | 4 | 5 | 6 | 7 | |
| 日(1) | 日 | 月 | 火 | 水 | 木 | 金 | 土 |
| 月(2) | 月 | 火 | 水 | 木 | 金 | 土 | 日 |
| 火(3) | 火 | 水 | 木 | 金 | 土 | 日 | 月 |
| 水(4) | 水 | 木 | 金 | 土 | 日 | 月 | 火 |
| 木(5) | 木 | 金 | 土 | 日 | 月 | 火 | 水 |
| 金(6) | 金 | 土 | 日 | 月 | 火 | 水 | 木 |
| 土(7) | 土 | 日 | 月 | 火 | 水 | 木 | 金 |
曜日番号から曜日名への変換
以下はgetWeekday関数 (自作関数)の第二引数とgetWeekdayName関数 (自作関数)の第三引数の値の関係を表にしたものです。
getWeekday関数 (自作関数)で取得した曜日番号をgetWeekdayName関数 (自作関数)で曜日名に変換するとき、この表に対応した数値を指定しないと正しい曜日名に変換することができません。
| getWeekday | getWeekdayName |
|---|---|
| 0 | 2 |
| 1 | 1 |
| 2 | 2 |
| 3 | 3 |
| 11 | 2 |
| 12 | 3 |
| 13 | 4 |
| 14 | 5 |
| 15 | 6 |
| 16 | 7 |
| 17 | 1 |
以下のtypeとfirstdayofweekの値を上の表と対応させてください。
typeに12を指定したときは、firstdayofweekに3を指定します。
使い方
曜日番号から曜日を取得
曜日番号が2の曜日名を取得します。曜日番号は日曜日が1、土曜日が7とした範囲の値が返ります。
- 結果
曜日番号から曜日を省略して取得
曜日番号が5の曜日名を取得します。abbreviateにTrueを指定しているので曜日は省略されます。
- 結果
指定日の曜日を取得
2024/10/07の曜日を取得します。まずgetWeekday関数 (自作関数)で日付を曜日番号に変換してからgetWeekdayName関数 (自作関数)で曜日名を取得します。
getWeekday関数 (自作関数)に2024/10/07を指定したとき2が戻り値として返り、getWeekdayName関数 (自作関数)の引数に2を渡すと、日曜日から数えて2番目である月曜日が返ります。
- 結果
今日の曜日を取得
今日の曜日を取得します。
参考文献
関連記事
- getWeekday関数 (自作関数)
- 引数に指定された日付の曜日番号(0:日曜〜6:土曜)を返します。
- getNthWeekday関数 (自作関数)
- 指定年月の第n週のw曜日(第nW曜日)の日付を返します。
- GETTIME関数 (スクリプト関数)
- 日付、時間を取得します。
- getYear関数 (自作関数)
- 指定された日付の年を返します。
- getMonth関数 (自作関数)
- 指定された日付の月を返します。
- getDay関数 (自作関数)
- 指定された日付の日を返します。
- isDate関数 (自作関数)
- 引数に指定した値が日付として認識できる場合はTrueを返します。認識できない場合はFalseを返します。
- getEndOfMonth関数 (自作関数)
- dateで指定された月の月末日を取得します。
- today関数 (自作関数)
- 今日の日付を返します。
- now関数 (自作関数)
- 現在の日時のシリアル値を返します。
