日付・時間

PHPの日付操作とフォーマット関数について解説

2025-02-20更新日: 2025-02-20

PHPの標準関数を利用して、柔軟で直感的な日付操作が可能です。

date関数やstrtotime関数を使えば、現在時刻の取得やフォーマット変換、計算処理がシンプルに実装できます。

この記事では、これらの基本機能について手軽に触れていきます。

目次から探す

PHPの日付操作の基本
- date関数の概要
- strtotime関数の利用方法
DateTimeクラスの活用
- DateTimeオブジェクトの生成と設定
- DateTime::formatメソッドの利用
日付の比較と計算処理
- 日付差分の取得方法
- 日付加算と減算の手法
PHPの日付操作における実務的留意点
- パフォーマンスの最適化
- エラー処理とデバッグの方法
まとめ

PHPの日付操作の基本

date関数の概要

基本フォーマットの指定方法

PHPのdate関数は、日付や時刻を任意の形式で出力するために広く使用されます。

例えば、書式文字列としてYは4桁の年、mは2桁の月、dは2桁の日を意味します。

書式文字列を変更することで自由に出力形式を変更できるため、用途に応じたフォーマットが可能です。

以下は、基本的なフォーマットの指定方法を示すサンプルコードです。

// サンプルコード: 年月日を "YYYY-MM-DD" の形式で出力
$currentDate = date("Y-m-d"); // "Y"は4桁の年、"m"は2桁の月、"d"は2桁の日を表す
echo $currentDate;

2023-10-06

現在時刻の取得例

date関数は現在時刻を取得するためにも使用できます。

例えば、時刻部分を追加して「YYYY-MM-DD HH:MM:SS」という形式で取得することができます。

以下は現在時刻を取得するサンプルコードです。

// サンプルコード: 現在の日時を "YYYY-MM-DD HH:MM:SS" の形式で出力
$currentDateTime = date("Y-m-d H:i:s"); // "H"は24時間制の時間、"i"は分、"s"は秒を表す
echo $currentDateTime;

2023-10-06 14:30:45

strtotime関数の利用方法

相対日付の計算

strtotime関数を使用すると、相対的な日付計算が簡単にできます。

例えば、"+1 week"を指定することで、1週間後のタイムスタンプが取得できます。

以下は、相対日付を計算するサンプルコードです。

// サンプルコード: 現在日付から1週間後の日付を取得
$timeAfterOneWeek = strtotime("+1 week");
$futureDate = date("Y-m-d", $timeAfterOneWeek); // "Y-m-d"形式にフォーマット
echo $futureDate;

2023-10-13

エラーチェックのポイント

strtotime関数は、無効な文字列を渡すとfalseを返すため、エラーが発生する可能性があります。

計算結果がfalseでないかチェックすることで、予期しない結果を回避できます。

以下はエラーチェックを行うサンプルコードです。

// サンプルコード: strtotime関数で無効な日付が指定された場合のエラーチェック
$time = strtotime("invalid date string");
if ($time === false) {
    echo "日付の解析に失敗しました。";
} else {
    echo date("Y-m-d", $time);
}

日付の解析に失敗しました。

DateTimeクラスの活用

DateTimeオブジェクトの生成と設定

タイムゾーン指定の方法

DateTimeクラスを使用する際、タイムゾーンを明示的に指定することで、異なる地域に対応した日時操作が可能です。

タイムゾーンはDateTimeZoneクラスで設定することができ、適切なタイムゾーンを指定することで正確な日時情報が得られます。

以下はタイムゾーンを指定してDateTimeオブジェクトを生成するサンプルコードです。

// サンプルコード: タイムゾーンを "Asia/Tokyo" に設定してDateTimeオブジェクトを生成
$timezone = new DateTimeZone("Asia/Tokyo");
$dateObject = new DateTime("now", $timezone); // 現在の日時を指定したタイムゾーンで設定
echo $dateObject->format("Y-m-d H:i:s");

2023-10-06 14:30:45

インスタンス生成の基本

DateTimeクラスのインスタンスは、現在日時または任意の日付文字列を渡すことで生成できます。

この方法により、より柔軟な日時操作が可能となります。

以下は、現在の日付と特定の日付でインスタンスを生成する例です。

// サンプルコード: 現在の日時と特定の日付からDateTimeオブジェクトを生成
$currentDate = new DateTime(); // 現在の日時
$specificDate = new DateTime("2023-01-01"); // 特定の日付を指定
echo $currentDate->format("Y-m-d H:i:s") . "\n";
echo $specificDate->format("Y-m-d");

2023-10-06 14:30:45
2023-01-01

DateTime::formatメソッドの利用

代表的なフォーマット例

DateTime::formatメソッドを使用することで、DateTimeオブジェクトの日時情報を任意のフォーマットで出力できます。

例えば、書式文字列をカスタマイズして「d/m/Y」形式に変換することが可能です。

以下は代表的なフォーマット例を示すサンプルコードです。

// サンプルコード: DateTimeオブジェクトを "d/m/Y H:i" の形式で出力
$dateObject = new DateTime("2023-10-06 14:30:45");
echo $dateObject->format("d/m/Y H:i");

06/10/2023 14:30

カスタムフォーマットの作成

必要に応じて、独自のフォーマットを定義することもできます。

例えば、曜日や月の英語表現を組み込んだ形式や、文字列と組み合わせたカスタムフォーマットなどが考えられます。

以下はカスタムフォーマットの作成例です。

// サンプルコード: 曜日や月の名称を含むカスタムフォーマットを作成
$dateObject = new DateTime("2023-10-06 14:30:45");
$customFormat = "l, F j, Y"; // 例: Friday, October 6, 2023
echo $dateObject->format($customFormat);

Friday, October 6, 2023

日付の比較と計算処理

日付差分の取得方法

diffメソッドの基本使い方

DateTimeオブジェクト同士の差分を取得するには、diffメソッドが便利です。

このメソッドを使用すると、2つの日付間の差分をDateIntervalオブジェクトとして受け取ることができます。

以下は、diffメソッドの基本的な使い方を示すサンプルコードです。

// サンプルコード: 2つの日付間の差分を取得する
$dateA = new DateTime("2023-10-06");
$dateB = new DateTime("2023-11-06");
$interval = $dateA->diff($dateB); // 差分の取得
echo $interval->format("%R%a days"); // %Rは差分の符号、%aは総日数を表す

+31 days

結果のフォーマット方法

取得したDateIntervalオブジェクトは、formatメソッドを使うことで読みやすい形式に変換することが可能です。

カスタムフォーマットを指定することで、差分を年、月、日、時間など細かく表示することができます。

以下は、DateIntervalオブジェクトの結果をフォーマットするサンプルコードです。

// サンプルコード: 差分を "X years, Y months, Z days" の形式で出力する
$dateA = new DateTime("2015-06-15");
$dateB = new DateTime("2023-10-06");
$interval = $dateA->diff($dateB);
echo $interval->format("%y years, %m months, %d days");

8 years, 3 months, 21 days

日付加算と減算の手法

DateIntervalの利用例

日付の加算や減算には、DateIntervalクラスを使用して日付の変更を行います。

このクラスを使うことで、特定の日数、月、年単位の計算がスムーズに行えます。

以下は、DateIntervalを使用して日付を加算するサンプルコードです。

// サンプルコード: 現在の日付から10日分を加算する例
$currentDate = new DateTime("2023-10-06");
$interval = new DateInterval("P10D"); // P10Dは10日間を意味する
$currentDate->add($interval); // 日付の加算
echo $currentDate->format("Y-m-d");