【フォーマットや操作】PHPのdate関数の使い方を徹底解説

PHPのdate関数は、日付と時間を扱う際に欠かせない関数です。

この記事では、フォーマットの基礎から日付操作の応用テクニックまで、幅広く解説しています。

初心者から経験豊富な開発者まで、日付データを効率的に操作し、PHPアプリケーションの機能を向上させるための実践的な知識を提供します。

早見表

時間がない人のために指定フォーマットをまとめました。

フォーマット

使いやすいもののみをピックアップしました。PHPの公式マニュアルではこれ以上にもフォーマット指定子が存在するので、必要であれば公式マニュアルもご覧ください。

https://www.php.net/manual/ja/datetime.format.php

実行サンプル

実際の使い方

<?php

echo date('Y-m-d H:i:s');
// "2023-09-07 02:55:32"
echo date('Ag時');
// "AM2時"
echo date('U');
// "1694055332"

echo date('T');
// "UTC"
date_default_timezone_set('Asia/Tokyo');
echo date('T');
// "JST"

// 日本語での曜日出力
$weeks = ['日', '月', '火', '水', '木', '金', '土'];
echo $weeks[date('w')];
// "木"

// 日付の加算、サンプルは1年加算
echo date('Y-m-d', strtotime('+1 year'));
// "2024-09-07"

とにかく早く使い方を知りたい人に向けた早見表でした。次からはdate関数の概要や詳細な使い方、ご自分のプロジェクトに使う方法などを解説していきます。

PHPのdate関数の基本

PHPのプログラミングにおいて日付と時間は非常に重要な要素です。これらを扱うための中心的なツールがdate関数です。

この関数は指定されたフォーマットに従って現在の日時や任意のタイムスタンプを文字列で返す機能を提供します。webアプリケーションでユーザーのタイムゾーンに基づいた日時を表示したり、ログファイルにタイムスタンプを記録する際など、様々なシーンで活用されます。

date関数の基本的な使い方

date関数を使用するには、まず第一引数に日付や時間を整形するためのフォーマット文字列を指定します。

第二引数はオプショナルで、展開したいUnixタイムスタンプを指定することができます。指定がない場合は、現在の日時が使用されます。

基本的な使い方の例がこちらになります。

echo date("Y/m/d"); // 現在の年月日を「2023/05/03」という形式で出力
echo date("H:i:s"); // 現在の時刻を24時間表記で「14:55:48」という形式で出力

日付フォーマットの指定方法は多岐にわたりますが、よく使われるのは以下のようなものです。

• Y は4桁の年を表します（例: 2023）
• m は2桁の月を表します（例: 04）
• d は2桁の日を表します（例: 09）
• H は2桁の時間（24時間制）を表します（例: 23）
• i は2桁の分を表します（例: 49）
• s は2桁の秒を表します（例: 36）

また、特定のタイムスタンプで日時を生成することも可能です。例えば、次のコードでは1970年1月1日から10000秒後の日時を計算しています。

echo date("Y-m-d H:i:s", 10000);  // 「1970-01-01 02:46:40」が出力される

このようにdate関数を用いることで、PHPにおける日時の管理と表示が非常に柔軟に行えます。

日付のフォーマット

PHPでは、日付を表示するフォーマットを多様に設定することができます。

最も一般的に使用されるのは

• Y/m/d
• M d, Y

といった形式です。

これらのフォーマットは、それぞれ年/月/日と月名 日, 年を表します。

echo date("Y/m/d");
// 2023/05/03

echo date("M d, Y");
// May 03, 2023

これらのフォーマットは、ログファイルのタイムスタンプや、ユーザーインターフェースでの日付表示に広く利用されています。

曜日と月の表示

日付フォーマットには曜日や月を表現するオプションも含まれています。

l（小文字のエル）は曜日の完全な名前を、Dは曜日の省略形を返します。

月の表示にはFが月の完全な名前（例: January）、Mが省略形（例: Jan）を返します。

日本語の曜日表示には対応していないため、事前に曜日の配列を用意して出力することができます。

// 曜日の出力
echo date("l");
// Monday
echo date("D");
// Mon

// 月の表示
echo date("F");
// January
echo date("M");
// Jan

// 日本語での曜日出力
$weeks = ['日', '月', '火', '水', '木', '金', '土'];
echo $weeks[date('w')];
// "木"

これらのフォーマットは、カレンダーやスケジューリングのアプリケーションで特に役立ちます。

時間帯と地域設定

PHPのdate関数では、サーバーの設定に依存するデフォルトの時間帯を使用しますが、date_default_timezone_set()関数を使用してプログラム内で時間帯を明示的に設定することもできます。

例えば、date_default_timezone_set('Asia/Tokyo')と設定すれば、以降のdate関数は日本時間を基準にして動作します。

echo date('T');
// "UTC"
date_default_timezone_set('Asia/Tokyo');
echo date('T');
// "JST"

これにより、国際的なアプリケーションで地域ごとに適切な日時表示を行うことが可能になります。

特殊な日付フォーマット

PHPでは、特定の地域や要件に合わせた特殊な日付フォーマットもサポートしています。

例えば、ドイツ語圏でよく用いられる日付表記はdate("d.m.Y")で03.05.2023のように点を使用します。

また、国際標準のISO 8601形式はdate("c")で表され、2023-05-03T14:55:48+09:00のような詳細なタイムスタンプが出力されます。

UTC時間の表示にはdate("Y-m-d\TH:i:s\Z")を使用し、2023-05-03T05:55:48Zという形式でグローバルな時間標準に準じた時間表記が可能です。

// ドイツ語圏の表記
echo date("d.m.Y");
// 03.05.2023

// ISO 8601
echo date("c");
// 2023-05-03T14:55:48+09:00

// UTC
echo date("Y-m-d\TH:i:s\Z");
// 2023-05-03T05:55:48Z

これらの特殊フォーマットは、国際的なデータ交換やログ記録に非常に有効です。

日付の加算と減算

PHPにおける日付の加算と減算は、strtotime関数やDateTimeクラスを使用して行います。

これらの関数は日付を柔軟に操作できるため、期間を加算したり、特定のイベントからの日数を計算するのに便利です。

strtotime関数の使用例

strtotime関数は、指定された文字列をUnixタイムスタンプに変換することができるため加減算した数値を返却し、それを元にdate関数で日付に直します。

例えば、現在の日付に1週間を加えたい場合は以下のようにします。

echo date("Y-m-d", strtotime("+1 week"));
// 現在日付から1週間後の日付を表示

また、特定の日付から1ヶ月を減算する場合は次のように記述します。

echo date("Y-m-d", strtotime("2023-05-03 -1 month"));
// 2023年5月3日から1ヶ月前の日付を表示

DateTimeクラスの使用例

DateTimeクラスを使用することで型が明確になるため、コードのバグを減らせるメリットやエディタツールの補完に対応することができます。

以下は、現在の日付に10日を加える例です。

$date = new DateTime(); // 現在の日付
$date->add(new DateInterval('P10D')); // 10日加算
echo $date->format('Y-m-d'); // 加算後の日付を表示

日付の比較とチェック

日付の比較やチェックは、アプリケーションで入力された日付が正しいかを確認したり、特定の条件を満たしているかを確認するのに重要です。

日付が正しいかの確認方法

checkdate関数を使用して、特定の日付が実際に存在するか（例えば2月30日は存在しない）どうかを確認できます。

var_dump(checkdate(2, 30, 2023)); // false, 2月30日は存在しない
var_dump(checkdate(4, 15, 2023)); // true, 4月15日は存在する

日付間の差分を求める方法

異なる日付の差分を求めるにはDateTimeクラスのdiffメソッドを使用します。

以下の例では、二つの日付間の差分を日数で取得しています。

$date1 = new DateTime("2023-05-03");
$date2 = new DateTime("2024-05-03");
$interval = $date1->diff($date2);
echo $interval->format('%R%a days'); // +365 days, 1年間の日数差

このように、PHPの日付操作関数を使用することで、日付の加算、減算、比較、正当性のチェックを行うことができます。

これらの機能は、ユーザーのデータ入力の検証、期間の計算、イベント管理など、多岐にわたるアプリケーションで有効です。

日付データの応用

ミリ秒単位の処理

PHPでは標準的に秒単位での日付と時刻の操作が主ですが、より精密な時間管理が必要な場合にはミリ秒単位での処理が求められることがあります。

ミリ秒を表示するためには "u"フォーマットを使用したり、microtime関数を使用します。

ミリ秒を含むタイムスタンプの生成

以下の例では、現在時刻をミリ秒単位で取得し、それを表示しています。

注意すべき点は date() の場合、これは常に 000000 となるため、DateTimeクラスを使用する必要があります。

// date() の場合、これは常に 000000 となります。
echo date('Y-m-d H:i:s.u');
// 2024-05-03 04:58:57.000000

// DateTimeを使わないと "u" は展開されない
$date = new DateTime();
echo $date->format('Y-m-d H:i:s.u');
// 2024-05-03 04:58:57.918511

ミリ秒を利用した実行時間の比較

リアルタイムでのイベント記録や、科学技術計算、高精度のログ記録などでミリ秒単位の時間データが重要になります。

例えば、特定のプロセスが開始してから終了するまでの正確な時間を計測する場合に microtime 関数は利用します。

$startTime = microtime(true); // 開始時間のミリ秒単位での取得
// プロセス処理
sleep(1); // 1秒間の処理停止（サンプル用）
$endTime = microtime(true); // 終了時間のミリ秒単位での取得
$duration = $endTime - $startTime; // 処理の実行時間を計算
echo "Duration: " . number_format($duration, 3) . " seconds."; // 実行時間の表示
// Duration: 1.005 seconds.

日付データの検索とソート

日付をキーにしたデータ検索や並び替えは、データベースやデータセットを扱う際に頻繁に遭遇するタスクです。

PHPを用いてこれらの処理を行う方法を見てみましょう。

日付データの検索

データベースから特定の日付範囲内のレコードを抽出する場合、SQLクエリを用いて行います。PHPでの実装例を以下に示します。

// PDOを使ったデータベース接続例
$pdo = new PDO('mysql:host=example_host;dbname=example_db', 'user', 'password');
// 特定の日付範囲でのデータ検索
$stmt = $pdo->prepare("SELECT * FROM events WHERE date >= :start_date AND date <= :end_date");
$stmt->execute([':start_date' => '2023-01-01', ':end_date' => '2023-12-31']);
$results = $stmt->fetchAll(PDO::FETCH_ASSOC);

日付データのソート

PHPの配列操作関数を用いて、取得したデータを日付順にソートする方法です。

$events = [
    ['date' => '2023-05-03', 'event' => 'Conference'],
    ['date' => '2023-05-01', 'event' => 'Meeting'],
    ['date' => '2023-05-02', 'event' => 'Workshop']
];
// 日付でソート
usort($events, function ($a, $b) {
    return strtotime($a['date']) - strtotime($b['date']);
});

これらの応用例を通じて、PHPで日付データをより効果的に操作し、データ駆動のアプリケーションやサービスを提供することができます。

よくある質問とトラブルシューティング

日付関数のFAQ

PHPのdate関数を使う際に、開発者やユーザーからよく寄せられる質問とその回答をまとめてみました。

これらはPHPで日付を扱う上での基本的な疑問を解消し、一般的な問題を解決するのに役立ちます。

Q1: date()関数で未来の日付を生成する方法は？

A: strtotime()関数と組み合わせて、特定の期間を加算することで未来の日付を生成できます。例えば、現在から1年後の日付は以下のようにして取得します。

echo date('Y-m-d', strtotime('+1 year'));

Q2: 月末の日付をどのように取得するのか？

A: 特定の月の最後の日を取得するにはdate()関数に't'をフォーマットとして渡します。これは指定された月の日数を返します。

echo date('Y-m-t'); // 現在の月の最終日

Q3: 日付形式を検証する方法は？

A: 日付が有効かどうかを検証するにはcheckdate()関数を使用します。例えば、2023-02-29が有効な日付かどうかをチェックするには以下のようにします。

var_dump(checkdate(2, 29, 2023)); // false, 2023年は閏年ではないため2月29日は存在しない

Q4: タイムゾーンの問題をどう解決するか？

A: タイムゾーンの問題はdate_default_timezone_set()関数で設定することで解決します。他にもサーバーのタイムゾーンを適切に設定することで、日付と時間が正確に反映されます。

date_default_timezone_set('Asia/Tokyo'); // タイムゾーンを東京に設定

Q5: PHPで年間の週番号をどのように取得するのか？

A: 年間の週番号(1月1日から何周目の週か)を取得するには、date()関数で'W'を使用します。これは指定した日付がその年の第何週目かを返します。

echo date('W'); // 現在の週番号

一般的なトラブルシューティングのポイント

日付関連の関数を使用する際に出会うかもしれない一般的な問題とその解決策を以下に示します。

• 問題: 日付が期待通りに表示されない。
  • 解決策: サーバーのタイムゾーン設定を確認し、必要に応じてdate_default_timezone_set()で調整します。
• 問題:strtotime()で予期しない結果が返される。
  • 解決策: 入力形式が正しいことを確認し、DateTimeクラスを使用してより堅牢な日付処理を行います。
• 問題: 年月日の形式が異なる日付データ間で不整合が生じる。
  • 解決策: すべての日付データを同じ形式（例: ISO 8601）に統一して処理します。

これらのFAQとトラブルシューティングのポイントは、日常的にPHPで日付を扱う際の助けとなるはずです。

まとめ

この記事では、PHPのdate関数を用いて日付と時間を効果的に操作する方法を幅広く紹介しました。基本的なフォーマットから日付の加算・減算、さらにはミリ秒単位での時間操作まで、具体的なコード例を交えて解説しました。これらの知識を活用することで、あなたのPHPプロジェクトはより柔軟かつ効率的に日付データを扱うことが可能です。

PHPでの日付操作は多くの場面で役立ちますので、ぜひこれを機にさらに深掘りしてみてください。また、日付操作に関する詳しいドキュメントや追加のリソースはPHP公式ドキュメントで確認することができます。

記事を最後まで読んでいただきありがとうございました。この記事があなたのプログラミングスキルの向上に役立つことを願っています。何か質問があれば、コメント欄でお気軽にお問い合わせください。次回の記事でも、役立つ情報を提供できるよう努めます。