メインコンテンツへスキップ
見出し画像

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…)


     
     
    プログラムを書いています。メイン言語はVBA、C++、C#、Python。Webサイトも運営しているので、noteのプロフィール欄URLから私のサイトにぜひお越しください! https://morinokabu.com/

    あなたへのおすすめ