
C#で「土日判定」をしたい時。DateTime.DayOfWeek列挙型の使い方
C#で日付データを扱う際、「その日付が何曜日か」によって処理を変えたいケースは非常に多くあります。
「土曜日または日曜日の場合は、週末料金を適用したい」
「月曜日の場合は、週次レポートを作成するタスクを実行したい」
DateTimeオブジェクトには、このような「曜日判定」を、非常に安全かつ直感的に行うための仕組みが備わっています。
DateTime.DayOfWeekプロパティ
DateTimeオブジェクト(例えば DateTime.Now など)は、DayOfWeekというプロパティを持っています。 これにアクセスすることで、その日付の「曜日」を取得できます。
戻り値は「文字列」でも「数値」でもない
ここで最も重要なポイントは、DayOfWeekプロパティが返す値の「型」です。
DayOfWeekプロパティは、"Sunday"のような**文字列(string)や、0のような整数(int)**を直接返すわけではありません。(※内部的には0=日曜日、1=月曜日...と関連付けられていますが、それを直接使うことは稀です)
DayOfWeekプロパティが返すのは、「DayOfWeek」という専用の「列挙型(enum)」です。
「列挙型(enum)」とは?
「列挙型」とは、あらかじめ「選択肢」がすべて定義された、特別な“リスト”のようなものです。 DayOfWeek列挙型には、以下の7つの“名前付きの選択肢”が用意されています。
DayOfWeek.Sunday
DayOfWeek.Monday
DayOfWeek.Tuesday
DayOfWeek.Wednesday
DayOfWeek.Thursday
DayOfWeek.Friday
DayOfWeek.Saturday
「列挙型」で判定するメリット
DayOfWeekが、この「列挙型」として返ってくることこそが、C#の曜日判定が安全である理由です。 これにより、私たちはif文やswitch文を使って、非常に直感的で読みやすいコードを書くことができます。
例えば、「週末かどうか」を判定したい場合、 DayOfWeekプロパティから取得した値が、 「DayOfWeek.Saturday」または「DayOfWeek.Sunday」と**「等しいか(==)」** を、そのまま比較すればよいのです。
文字列の"Saturday"と比較する時のように、「大文字・小文字」の違い("saturday")を心配する必要も、0や6といった“マジックナンバー”(数字の直接書き)で悩む必要もありません。
続きはブログで:if文とswitch文の具体的なコード
この記事では、DateTime.DayOfWeekプロパティが「列挙型(enum)」として曜日を返すという「概念」についてご紹介しました。
「では、if文を使って『週末判定』を行う、具体的なC#コードは?」 「switch文を使って、月曜日は『週次ミーティング』、水・金は『リリース日』、土日は『休業日』のように、曜日ごとに処理を分岐させるサンプルコードは?」 「取得したDayOfWeek列挙型を、"Sunday"のような文字列として表示するには?」
と思われた方もいらっしゃるかと思います。
私の運営する技術ブログでは、この記事の続きとして、if文やswitch文を使った曜日判定の具体的なC#サンプルコードと、その実行結果を交えて、DayOfWeekプロパティの実用的な使い方を詳しく解説しています。
詳細は、ぜひ以下のリンクからご覧ください。
▼ブログ記事はこちら 【C#】DateTime.DayOfWeekプロパティで曜日を判定する方法 (Sunday, Monday…)