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

DAY_7定数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年03月13日

基本的な使い方

DAY_7定数は、日付や時刻を扱う際に週の7日目を表す定数です。この定数は、主に曜日を識別し、プログラム内で特定の曜日に関連する処理を記述する際に利用されます。例えば、週の始まりを月曜日とする一般的な慣例に従う場合、DAY_7は日曜日を指し示します。PHPのdate()関数などで得られる曜日の数値表現と連携して、週の最終日に特定のタスクを実行するような条件分岐や、レポート生成のトリガー設定などに活用できます。

このような定数を使用する利点は、コードの可読性と保守性を向上させる点にあります。具体的な数値（いわゆるマジックナンバー）を直接コードに埋め込む代わりにDAY_7という意味の通る名前を用いることで、その数値が何を意味するのかが一目で分かり、プログラムを読み解く負担が軽減されます。また、将来的に曜日に関する定義が変更された場合でも、定数の値だけを修正すれば済むため、広範囲にわたるコードの修正を防ぎ、システムの堅牢性を高めます。日付の計算、スケジュールの管理、特定の曜日に応じた表示の切り替えなど、様々な場面でプログラミングの効率と安全性を高めるための重要な要素となります。

構文(syntax)


1DAY_7

引数(parameters)

引数なし

引数はありません

戻り値(return)

戻り値なし

戻り値はありません

サンプルコード

PHPでDAY_7を使って日付を計算する


1<?php
2
3// DAY_7 定数はPHPの標準ライブラリには存在しませんが、
4// 提供されたリファレンス情報とキーワードに基づき、
5// この定数が「7」という整数値を保持し、日数を表すものと仮定して定義します。
6const DAY_7 = 7;
7
8/**
9 * 現在の日付から指定された日数分、日付を計算し、その結果を表示します。
10 *
11 * @param int $offsetDays 現在の日付からのオフセット日数。
12 *                        正の数で未来の日付を、負の数で過去の日付を計算します。
13 * @return void
14 */
15function displayDateWithOffset(int $offsetDays): void
16{
17    // 現在の日付と時刻を取得します。
18    $currentDate = new DateTime();
19    echo "現在の日付: " . $currentDate->format('Y-m-d') . PHP_EOL;
20
21    // 現在の日付オブジェクトをクローンし、計算による元のオブジェクトの変更を防ぎます。
22    $calculatedDate = clone $currentDate;
23    
24    // DateTime::modify() メソッドを使用して日付を加算または減算します。
25    // 例: "7 days" で7日後、"-7 days" で7日前。
26    $calculatedDate->modify("{$offsetDays} days");
27
28    // 計算後の日付を表示します。
29    echo "計算後の日付 ({$offsetDays}日後): " . $calculatedDate->format('Y-m-d') . PHP_EOL;
30}
31
32// 定数 DAY_7 を使って、現在から7日後の日付を計算し表示します。
33displayDateWithOffset(DAY_7);
34
35// 参考: DAY_7 を使って7日前の日付を計算し表示する例
36// displayDateWithOffset(-DAY_7);

このPHPコードは、現在の日付を基準に特定の日数分だけ未来や過去の日付を計算し、表示する方法を示しています。サンプルコード内では便宜的にDAY_7という定数が「7」という整数値として定義されており、日数を表す目的で利用されています。

displayDateWithOffset関数は、日付を計算して表示する役割を持ちます。この関数は$offsetDaysという整数型の引数を受け取ります。$offsetDaysには、現在の日付から何日ずらすかを指定します。正の値を渡すと未来の日付を、負の値を渡すと過去の日付を計算します。この関数自体は計算結果を表示するだけで、特定の値を返しません（void）。

関数内部では、PHPのDateTimeクラスを用いて現在の日付時刻を取得し、そのmodify()メソッドに"N days"形式の文字列を渡すことで、指定された日数分の日付を加算または減算しています。これにより、柔軟な日付計算が可能です。

このサンプルコードを実行すると、定数DAY_7の値（7）を使って、現在から7日後の日付が計算され、画面に表示されます。

このサンプルコードで利用されているDAY_7定数は、PHPの標準ライブラリには元々存在しません。そのため、コード内でconst DAY_7 = 7;として独自に定義している点にご注意ください。もし、このDAY_7が実際には特定のPHP拡張機能の一部であるならば、その拡張機能がサーバーにインストールされ、有効化されている必要があります。

日付操作を行うDateTimeオブジェクトは、変数を代入する際に参照渡しとなります。そのため、displayDateWithOffset関数内で元の$currentDateオブジェクトが意図せず変更されないように、cloneを使って新しいオブジェクトを複製してから操作している点が重要です。modify()メソッドは、引数に"7 days"や"-7 days"のように日数を指定することで、現在の日付から簡単に加算・減算が可能です。