【PHP8.x】DAY_2定数の使い方

Copy
1<?php
2
3/**
4 * DAY_2 定数を定義します。
5 *
6 * この定数は、提供されたリファレンス情報に基づき、
7 * 特定の値（この場合は数値の「2」）を表現するものと解釈されます。
8 * PHPの標準ライブラリには「DAY_2」という定数は存在しませんが、
9 * リファレンス情報に従い、ここで定義しています。
10 *
11 * 「戻り値なし」という記述は、定数が関数のように実行されて値を返すものではなく、
12 * 直接値を保持するものであることを示唆していると解釈されます。
13 */
14const DAY_2 = 2; // 週の2日目（火曜日）や、月の2日目などを表す数値として使用できます。
15
16/**
17 * 指定された年の各月のDAY_2（2日目）が何曜日かをPHPの推奨スタイルで表示します。
18 *
19 * この関数は、DateTimeImmutable クラスを使用して日付を安全に操作し、
20 * 各月の2日目がどの曜日になるかを初心者にも分かりやすい形式で出力します。
21 *
22 * @param int $year 確認したい年（例: 2025）
23 * @return void 出力のみを行い、値を返しません。
24 */
25function displayDay2OfMonth($year): void
26{
27    echo "--- {$year}年の各月の" . DAY_2 . "日目 ---\n";
28
29    // 1月から12月までループします。
30    for ($month = 1; $month <= 12; $month++) {
31        // DateTimeImmutable オブジェクトを作成し、不変な日付を扱います。
32        // 指定された年、現在の月、そして定義した定数DAY_2（2日）を使用して日付を設定します。
33        // このアプローチは、日付計算における予期せぬ副作用を防ぐために推奨されます。
34        $date = new DateTimeImmutable("{$year}-{$month}-" . DAY_2);
35
36        // 日付を「YYYY-MM-DD (曜日)」形式で出力します。
37        // 'Y': 4桁の年 (例: 2025)
38        // 'm': 先頭にゼロが付く月 (例: 01, 12)
39        // 'd': 先頭にゼロが付く日 (例: 02)
40        // 'l': 曜日の完全な英語名 (例: Monday, Tuesday)
41        echo $date->format('Y-m-d (l)') . "\n";
42    }
43}
44
45// 2025年について、各月のDAY_2（2日目）の曜日を表示します。
46// キーワード「php day 2025」と提供された定数「DAY_2」を関連付けています。
47displayDay2OfMonth(2025);
48

このPHPコードは、「DAY_2」という定数を定義し、特定の年の各月の2日目が何曜日になるかを初心者にも分かりやすく表示するものです。

まず、DAY_2は、日を表す数値「2」を保持する定数として定義されています。これは、提供されたリファレンス情報に「DAY_2」定数があり、戻り値がないと示されているため、直接値を保持する定数としてサンプルコードで独自に定義したものです。

次に、displayDay2OfMonth関数は、引数として受け取った$year（年）の各月について、DAY_2で定義された日付（つまり各月の2日）の曜日を特定し表示します。この関数は、日付操作を安全に行うために推奨されるDateTimeImmutableクラスを使用しています。関数内部では、指定された年、現在の月、そして定数DAY_2を組み合わせて各月2日の日付オブジェクトを作成し、その日付を「YYYY-MM-DD (曜日)」という形式で画面に出力します。

displayDay2OfMonth関数の引数$yearは、確認したい年（例: 2025）を指定する整数です。戻り値の型はvoidとされており、これは関数が何らかの値を計算して返すのではなく、処理として画面への出力のみを行うことを意味します。

コードの最後では、displayDay2OfMonth(2025)と呼び出すことにより、2025年1月から12月までの各月の2日目が何曜日になるかを一覧で確認することができます。これにより、「php day 2025」というキーワードと「DAY_2」定数が関連付けられ、具体的な日付と曜日の情報が得られます。

Copy
1<?php
2
3/**
4 * DAY_2 定数を定義します。
5 * リファレンス情報にある「DAY_2」は、PHPの標準拡張には一般的に存在しないため、
6 * ここではキーワード「day」と「2」を関連付け、曜日を表す定数として仮定します。
7 * PHPの date('w') 関数は日曜日を0、月曜日を1、火曜日を2として返すため、
8 * DAY_2 が火曜日を意味すると想定し、値 2 を割り当てます。
9 * 
10 * 実際のプロジェクトでは、このようなカスタム定数は特定のライブラリやフレームワーク、
11 * あるいはプロジェクト固有の定義ファイルで提供されます。
12 *
13 * @link https://www.php.net/manual/ja/function.define.php PHP: define - Manual
14 */
15define('DAY_2', 2);
16
17/**
18 * 指定された日付が DAY_2 (火曜日) であるかどうかを判定し、その結果を表示します。
19 * システムエンジニアを目指す初心者の方にも、PHPでの日付操作と定数の利用方法を理解してもらうためのサンプルです。
20 *
21 * @param string $dateString 判定したい日付を表す文字列 (例: 'YYYY-MM-DD').
22 * @return void この関数は値を返さず、直接結果を出力します。
23 */
24function checkDateForDay2(string $dateString): void
25{
26    echo "--- 日付判定: " . $dateString . " ---\n";
27
28    // 1. 日付文字列をUnixタイムスタンプに変換します。
29    //    strtotime() 関数は、様々な日付文字列をタイムスタンプに変換します。
30    //    変換に失敗した場合は false を返します。
31    $timestamp = strtotime($dateString);
32
33    if ($timestamp === false) {
34        echo "エラー: 無効な日付フォーマット '{$dateString}' が指定されました。\n";
35        echo "処理を終了します。\n";
36        return;
37    }
38
39    // 2. タイムスタンプから曜日を取得します。
40    //    date('w', $timestamp) は、日曜を '0'、月曜を '1'、...、土曜を '6' として返します。
41    $dayOfWeek = (int) date('w', $timestamp);
42
43    echo "対象日付: " . $dateString . "\n";
44    echo "取得された曜日 (数値): " . $dayOfWeek . " (日=0, 月=1, 火=2, ...)\n";
45    echo "比較対象の定数 DAY_2: " . DAY_2 . "\n";
46
47    // 3. 取得した曜日が DAY_2 (値: 2、つまり火曜日) と一致するかを判定します。
48    if ($dayOfWeek === DAY_2) {
49        echo "結果: {$dateString} は DAY_2 (火曜日) です。\n";
50    } else {
51        echo "結果: {$dateString} は DAY_2 (火曜日) ではありません。\n";
52    }
53    echo "\n";
54}
55
56// キーワード「php day 2026」に関連する日付で関数を呼び出し、動作を確認します。
57// 2026年1月1日は木曜日です。
58checkDateForDay2('2026-01-01');
59
60// 2026年1月6日は火曜日です。
61checkDateForDay2('2026-01-06');
62
63// 2026年1月7日は水曜日です。
64checkDateForDay2('2026-01-07');
65
66// 存在しない日付でのエラーハンドリングの例
67checkDateForDay2('2026-02-30');
68
69?>

このPHPサンプルコードは、「DAY_2」というカスタム定数を利用し、指定された日付が火曜日であるかを判定する方法を初心者向けに示しています。提示されたリファレンスの「DAY_2」はPHP標準の拡張定数には一般的に存在しないため、このコードでは曜日を表すものとして独自に定義しています。具体的には、PHPのdate('w')関数が日曜日を0、月曜日を1、火曜日を2と返すことを踏まえ、define('DAY_2', 2);によって火曜日を意味する定数としています。

checkDateForDay2関数は、引数$dateStringで渡された日付文字列がDAY_2（火曜日）であるかを判定する役割を担います。この関数は値を返さず（戻り値void）、判定結果を直接画面に出力します。関数内ではまず、strtotime()関数で日付文字列をUnixタイムスタンプに変換します。変換に失敗した場合はエラーを表示します。次に、date('w')関数でタイムスタンプから曜日を数値として取得し、定義したDAY_2定数と比較します。この比較により、対象の日付が火曜日であるかどうかが判断され、その結果がわかりやすく表示されます。このコードを通じて、PHPでの日付操作の基本と定数の利用方法を具体的に理解することができます。