PHPで日付を「昨日」「3日前」などのテキスト形式で表示する方法

PHPで日付をテキスト形式に変換することは、Webアプリケーションやブログなどでユーザー体験を向上させる重要な手法です。たとえば、投稿日時を「2024年10月24日」と表示するのではなく、「昨日」や「3日前」といった相対的な表現を使用することで、ユーザーにとってより直感的で理解しやすい表示が可能になります。本記事では、PHPを使って日付を「昨日」や「3日前」などのテキスト形式で表示する方法について、基本的な実装から応用的なテクニックまで、幅広く解説していきます。

日付をテキスト形式で表示する理由

ユーザーインターフェースにおいて、日付を相対的なテキスト形式で表示することは、ユーザーの体験を向上させるための効果的な方法です。「昨日」や「3日前」といった表現は、具体的な日付よりも直感的で理解しやすく、コンテンツの鮮度や時間経過を伝えるのに役立ちます。また、ソーシャルメディアやブログのコメントセクションなどでは、相対的な日付表示が特に一般的です。これにより、ユーザーが情報の新しさを瞬時に把握でき、閲覧体験が向上します。

基本的なPHPの日時関数の紹介

PHPには、日時の操作に役立ついくつかの基本的な関数があります。これらの関数を使用することで、日付の取得、操作、フォーマットを簡単に行うことができます。

date()関数

date()関数は、現在の日時を指定したフォーマットで取得するための関数です。たとえば、date('Y-m-d')は「2024-10-24」のような形式で日付を表示します。

time()関数

time()関数は、現在のタイムスタンプ（UNIXエポックからの秒数）を返します。これを使うことで、現在時刻と他の日付との比較や計算が容易になります。

strtotime()関数

strtotime()関数は、人間が読める形式の文字列をタイムスタンプに変換するための関数です。たとえば、strtotime('yesterday')は「昨日の同じ時刻」のタイムスタンプを返します。

これらの関数を組み合わせて使うことで、PHPでの柔軟な日付操作が可能になります。

相対的な日付の計算方法

PHPでは、相対的な日付の計算を行うためにタイムスタンプを活用し、特定の日付との差を計算することができます。タイムスタンプはUNIXエポック（1970年1月1日 00:00:00 UTC）からの経過秒数で表され、日付間の計算が容易です。

現在の日付との差を求める

現在の日付と特定の日付との差を求めるには、まず両方のタイムスタンプを取得します。そして、これらの差を計算することで、時間の経過を秒単位で把握できます。

$now = time(); // 現在のタイムスタンプ
$past = strtotime('2024-10-21'); // 特定の日付のタイムスタンプ
$diff = $now - $past; // 差分を計算

秒数から日数への変換

タイムスタンプの差を日数に変換するには、秒数を「86400」（1日の秒数）で割ります。これにより、特定の日付からの経過日数を求めることができます。

$daysAgo = floor($diff / 86400); // 経過日数を計算

相対的な日付表示の実装

この計算をもとに、「昨日」や「3日前」のように動的に表示することが可能です。例えば、経過日数が1であれば「昨日」、それ以上であれば「n日前」と表示することができます。

相対的な日付計算を適切に実装することで、ユーザーにとってわかりやすい日付表示を実現できます。

PHPで「昨日」「今日」などを表示する実装方法

PHPを使って、特定の日付を「昨日」や「今日」、「3日前」のように相対的なテキスト形式で表示する方法を実装します。これには、日付の差を計算してその結果に応じた文字列を返す仕組みを構築します。

実装例：日付のテキスト形式変換関数

以下のコード例では、日付のタイムスタンプを受け取り、その日付が現在からどれだけ前かを判定して、「今日」「昨日」「n日前」のいずれかを返します。

function formatDateToText($timestamp) {
    $now = time();
    $diff = $now - $timestamp;
    $daysAgo = floor($diff / 86400); // 1日の秒数で割る

    if ($daysAgo == 0) {
        return "今日";
    } elseif ($daysAgo == 1) {
        return "昨日";
    } else {
        return $daysAgo . "日前";
    }
}

// 使用例
echo formatDateToText(strtotime('2024-10-23')); // 「昨日」と表示
echo formatDateToText(strtotime('2024-10-20')); // 「4日前」と表示

コードの解説

time()関数で現在のタイムスタンプを取得します。
与えられたタイムスタンプと現在のタイムスタンプの差分を計算し、経過秒数を求めます。
経過秒数を「86400」（1日の秒数）で割って日数に変換します。
日数に応じて「今日」「昨日」「n日前」のいずれかを返します。

この方法を用いることで、簡単に相対的な日付表示を実現できます。

日付差から「n日前」「nヶ月前」を表示する方法

日付の差を計算して「n日前」や「nヶ月前」のように表示することで、より詳細な相対的な日付の表現を提供できます。このセクションでは、PHPを使って日付差を計算し、テキスト形式に変換する方法を解説します。

日数だけでなく月単位の計算も含める

日数だけでなく、月単位の差を考慮するために、日付の差を秒単位から日単位、さらに月単位へと変換して処理します。

日付差を計算して「n日前」「nヶ月前」を表示する実装例

以下のコード例では、日付の差に基づいて「今日」「昨日」「n日前」「nヶ月前」のいずれかを返します。

function formatDateToRelativeText($timestamp) {
    $now = time();
    $diff = $now - $timestamp;
    $daysAgo = floor($diff / 86400); // 1日の秒数で割る
    $monthsAgo = floor($daysAgo / 30); // 1ヶ月を30日として計算

    if ($daysAgo == 0) {
        return "今日";
    } elseif ($daysAgo == 1) {
        return "昨日";
    } elseif ($daysAgo < 30) {
        return $daysAgo . "日前";
    } else {
        return $monthsAgo . "ヶ月前";
    }
}

// 使用例
echo formatDateToRelativeText(strtotime('2024-09-24')); // 「1ヶ月前」と表示
echo formatDateToRelativeText(strtotime('2024-10-20')); // 「4日前」と表示

コードの解説

time()関数で現在のタイムスタンプを取得します。
与えられたタイムスタンプと現在のタイムスタンプの差分を計算し、経過秒数から日数に変換します。
日数に基づいて、「今日」「昨日」「n日前」「nヶ月前」のいずれかを返します。
月単位の計算は、1ヶ月を30日とする簡易的な計算で行います。

この方法を使えば、「n日前」だけでなく「nヶ月前」まで対応できる柔軟な日付表示を実現できます。

カスタマイズ可能な日付フォーマットの実装

日付をテキスト形式で表示する際、特定のフォーマットをカスタマイズできると便利です。PHPを使って、柔軟にカスタマイズ可能な日付表示を実装する方法を紹介します。

フォーマットオプションの設定

ユーザーが自由にフォーマットを指定できるようにするため、日付表示のフォーマットオプションを関数に渡せるようにします。これにより、「今日」「昨日」の表示や「n日前」などをカスタマイズできます。

実装例：カスタマイズ可能な日付フォーマット関数

以下のコード例では、フォーマットをオプションとして指定し、それに応じて出力を変えることができる関数を作成します。

function formatDateWithCustomFormat($timestamp, $formatOptions = []) {
    $now = time();
    $diff = $now - $timestamp;
    $daysAgo = floor($diff / 86400); // 1日の秒数で割る
    $monthsAgo = floor($daysAgo / 30); // 1ヶ月を30日として計算

    // デフォルトフォーマット
    $defaultFormats = [
        'today' => '今日',
        'yesterday' => '昨日',
        'days_ago' => '%d日前',
        'months_ago' => '%dヶ月前'
    ];

    // フォーマットの上書き
    $formats = array_merge($defaultFormats, $formatOptions);

    // 日付の形式に応じた表示
    if ($daysAgo == 0) {
        return $formats['today'];
    } elseif ($daysAgo == 1) {
        return $formats['yesterday'];
    } elseif ($daysAgo < 30) {
        return sprintf($formats['days_ago'], $daysAgo);
    } else {
        return sprintf($formats['months_ago'], $monthsAgo);
    }
}

// 使用例
echo formatDateWithCustomFormat(strtotime('2024-09-24'), [
    'today' => '本日',
    'yesterday' => '前日',
    'days_ago' => '%d日経過',
    'months_ago' => '%dヶ月経過'
]); // 「1ヶ月経過」と表示

コードの解説

デフォルトのフォーマットを定義し、カスタムフォーマットをオプションで受け取ります。
指定されたフォーマットオプションでデフォルトを上書きします。
日付の差に応じて、適切なフォーマットを用いて表示を行います。
sprintf()関数を使用して、日数や月数をフォーマットに組み込みます。

この方法により、様々な形式で日付を柔軟にカスタマイズし、特定のニーズに合った表示が可能になります。

多言語対応のための日付テキスト変換

多言語対応を考慮した日付テキスト変換は、国際化対応が求められるアプリケーションにおいて重要です。PHPでは、言語ごとに異なるフォーマットで日付を表示するための仕組みを柔軟に実装できます。

言語ごとのテキスト設定

異なる言語で「今日」「昨日」「n日前」「nヶ月前」などを表示するには、言語ごとのテキストを設定する仕組みを用意します。これにより、ユーザーの言語環境に応じた適切な日付表現が可能です。

実装例：多言語対応の日付変換関数

以下のコード例では、指定された言語に応じて日付テキストを動的に変換する方法を示します。

function formatDateForLocale($timestamp, $locale = 'ja') {
    $now = time();
    $diff = $now - $timestamp;
    $daysAgo = floor($diff / 86400); // 1日の秒数で割る
    $monthsAgo = floor($daysAgo / 30); // 1ヶ月を30日として計算

    // 言語ごとのフォーマット設定
    $translations = [
        'ja' => [
            'today' => '今日',
            'yesterday' => '昨日',
            'days_ago' => '%d日前',
            'months_ago' => '%dヶ月前'
        ],
        'en' => [
            'today' => 'Today',
            'yesterday' => 'Yesterday',
            'days_ago' => '%d days ago',
            'months_ago' => '%d months ago'
        ],
        'fr' => [
            'today' => "Aujourd'hui",
            'yesterday' => 'Hier',
            'days_ago' => 'Il y a %d jours',
            'months_ago' => 'Il y a %d mois'
        ]
    ];

    // 指定された言語のフォーマットを使用、なければデフォルトで日本語
    $formats = $translations[$locale] ?? $translations['ja'];

    // 日付の形式に応じた表示
    if ($daysAgo == 0) {
        return $formats['today'];
    } elseif ($daysAgo == 1) {
        return $formats['yesterday'];
    } elseif ($daysAgo < 30) {
        return sprintf($formats['days_ago'], $daysAgo);
    } else {
        return sprintf($formats['months_ago'], $monthsAgo);
    }
}

// 使用例
echo formatDateForLocale(strtotime('2024-09-24'), 'en'); // 「1 month ago」と表示
echo formatDateForLocale(strtotime('2024-10-20'), 'fr'); // 「Il y a 4 jours」と表示

コードの解説

localeパラメータを使用して言語を指定し、言語ごとのテキスト設定を切り替えます。
各言語の翻訳テキストを配列で定義し、対応するキーに基づいて日付テキストを表示します。
指定された言語の設定がない場合は、デフォルトで日本語のフォーマットを使用します。

この方法を使うことで、多言語対応の日付表示が可能となり、グローバルなユーザー向けに最適化されたアプリケーションを構築できます。

日付フォーマットのユニットテストの書き方

日付をテキスト形式に変換する関数が正しく動作することを確認するためには、ユニットテストが欠かせません。PHPでは、PHPUnitを使用して日付フォーマットのテストを行うことができます。ここでは、日付変換関数のユニットテストの実装方法について説明します。

PHPUnitのインストールと設定

まず、PHPUnitをインストールする必要があります。Composerを使ってプロジェクトにインストールします。

composer require --dev phpunit/phpunit

次に、PHPUnitの設定ファイル（phpunit.xml）をプロジェクトのルートに作成します。

ユニットテストの作成例

以下の例では、日付変換関数が「今日」「昨日」「n日前」および「nヶ月前」を正しく返すかどうかを確認するテストケースを作成します。

use PHPUnit\Framework\TestCase;

class DateFormatterTest extends TestCase
{
    public function testFormatDateToTextToday()
    {
        $result = formatDateToText(time());
        $this->assertEquals('今日', $result);
    }

    public function testFormatDateToTextYesterday()
    {
        $result = formatDateToText(strtotime('-1 day'));
        $this->assertEquals('昨日', $result);
    }

    public function testFormatDateToTextDaysAgo()
    {
        $result = formatDateToText(strtotime('-5 days'));
        $this->assertEquals('5日前', $result);
    }

    public function testFormatDateToTextMonthsAgo()
    {
        $result = formatDateToText(strtotime('-45 days'));
        $this->assertEquals('1ヶ月前', $result);
    }

    public function testFormatDateToTextCustomLocale()
    {
        $result = formatDateForLocale(strtotime('-1 day'), 'en');
        $this->assertEquals('Yesterday', $result);
    }
}

コードの解説

PHPUnit\Framework\TestCaseクラスを継承してテストクラスを作成します。
各テストメソッドで、日付変換関数の結果が期待通りかどうかをassertEquals()で確認します。
テストケースは、異なる日付の入力やロケールに対する期待される出力を検証します。

テストの実行

PHPUnitをコマンドラインから実行して、テストを実施します。

vendor/bin/phpunit tests/DateFormatterTest.php

テストがすべて通過すれば、日付変換関数が正しく動作していることが確認できます。これにより、コードの品質を高め、将来的な変更に対する回帰テストとしても活用できます。

応用例：ブログ記事の投稿日をテキスト形式で表示する

ブログなどのWebサイトでは、記事の投稿日を「昨日」「3日前」といった相対的な日付で表示することで、ユーザーにとって情報の鮮度を直感的に伝えることができます。ここでは、ブログ記事の投稿日をPHPを使ってテキスト形式で表示する実装方法を紹介します。

データベースから取得した日付をフォーマットする

ブログ記事の投稿日がデータベースに保存されている場合、その日付を取得し、テキスト形式で表示する処理を行います。例として、投稿日を「2024-10-20」のような形式で保存している場合を想定します。

// データベースから取得した記事の投稿日（例として文字列で取得）
$postedDate = '2024-10-20';

// 日付をタイムスタンプに変換
$timestamp = strtotime($postedDate);

// テキスト形式で日付を表示する関数を利用
$relativeDate = formatDateToRelativeText($timestamp);

// 表示
echo "この記事は" . $relativeDate . "に投稿されました。"; // 「この記事は4日前に投稿されました。」と表示

コードの解説

データベースから取得した日付文字列をstrtotime()でタイムスタンプに変換します。
既に実装したformatDateToRelativeText()関数を使用して、日付を相対的なテキスト形式に変換します。
変換された日付を表示することで、ユーザーに対して直感的な情報を提供します。

テンプレートエンジンとの統合

テンプレートエンジン（例：TwigやBlade）を使用している場合でも、この日付フォーマット関数を組み合わせることで簡単に相対的な日付表示が可能です。たとえば、Twigでの使用例は以下のようになります。

{# Twigテンプレート内での使用例 #}
この記事は{{ formatDateToRelativeText(postedDate|date('U')) }}に投稿されました。

ここでpostedDateは日付オブジェクトとして渡され、date('U')フィルタを用いることでタイムスタンプに変換されます。その後、PHPのカスタム関数formatDateToRelativeText()を利用してテキスト形式に変換します。

応用例の効果

相対的な日付表示を使うことで、ユーザーはブログ記事の新鮮さを瞬時に把握でき、記事の閲覧体験が向上します。この実装は、SNSの投稿やコメント日時の表示など、他のシステムにも応用可能です。

トラブルシューティング：表示が正しくない場合の対策

PHPで日付をテキスト形式に変換する際、期待した表示結果が得られない場合があります。ここでは、よくある問題とその解決方法について解説します。

問題1: タイムゾーン設定の不備

サーバーのタイムゾーン設定が適切でない場合、表示される日付がズレることがあります。PHPのタイムゾーン設定がサーバーのタイムゾーンと一致しているかを確認し、必要に応じて修正します。

// タイムゾーンの設定
date_default_timezone_set('Asia/Tokyo');

この設定をスクリプトの冒頭に追加することで、タイムゾーンの問題を防ぐことができます。

問題2: strtotime()が正しく動作しない

strtotime()関数が正しく日付文字列を解釈できない場合があります。日付フォーマットが標準的な形式でない場合、エラーや予期しない結果が発生する可能性があります。

日付フォーマットを見直し、標準的な形式（例：YYYY-MM-DD）を使用する。
DateTimeクラスを使用して、より厳密な日付のパースを行う。

$date = DateTime::createFromFormat('Y-m-d', '2024-10-20');
$timestamp = $date ? $date->getTimestamp() : time(); // エラー時は現在時刻を使用

問題3: テキスト形式の表示が意図した通りでない

日数や月数の計算に誤りがある場合、テキスト形式が期待した表示と異なることがあります。特に、月単位の計算を簡略化して行っている場合（例：1ヶ月を30日とみなすなど）、厳密な計算が必要になることがあります。

DateTimeクラスを使って、より精密に日付の差を計算する方法を検討します。

$start = new DateTime('2024-10-20');
$end = new DateTime();
$interval = $start->diff($end);
$monthsAgo = $interval->m + ($interval->y * 12); // 年も考慮

問題4: ロケール対応が不十分

多言語対応が必要な場合、言語ごとに正しいフォーマットが適用されないことがあります。使用する翻訳テキストが不足している場合や、翻訳設定が間違っている可能性があります。

言語設定を明示的に渡すことで、適切な翻訳が使用されるようにします。
翻訳テキストを見直し、不足がないか確認します。

デバッグと対策

トラブルが発生した場合は、以下のデバッグ手法を試してみてください。

var_dump()やprint_r()を使ってタイムスタンプや計算結果を確認します。
error_log()を使用してエラーメッセージを記録し、問題の特定を行います。
日付の計算にDateTimeクラスを使用して、予期しない挙動を回避します。

これらのトラブルシューティング手法を用いることで、表示が正しくない問題に対処し、より安定した日付表示を実現できます。

まとめ

本記事では、PHPで日付を「昨日」「3日前」などのテキスト形式で表示する方法について解説しました。基本的な日時関数から始め、相対的な日付表示の実装、多言語対応、カスタマイズ方法、さらにはユニットテストの作成やトラブルシューティングまで幅広く取り上げました。これにより、ユーザーにとって直感的でわかりやすい日付表示を実現し、Webアプリケーションのユーザー体験を向上させることが可能になります。正しい日付表示を行うための知識を活用し、プロジェクトでぜひ役立ててください。

PHPで日付を「昨日」「3日前」などのテキスト形式で表示する方法

日付をテキスト形式で表示する理由

基本的なPHPの日時関数の紹介

date()関数

time()関数

strtotime()関数

相対的な日付の計算方法

現在の日付との差を求める

秒数から日数への変換

相対的な日付表示の実装

PHPで「昨日」「今日」などを表示する実装方法

実装例：日付のテキスト形式変換関数

コードの解説

日付差から「n日前」「nヶ月前」を表示する方法

日数だけでなく月単位の計算も含める

日付差を計算して「n日前」「nヶ月前」を表示する実装例

コードの解説

カスタマイズ可能な日付フォーマットの実装

フォーマットオプションの設定

実装例：カスタマイズ可能な日付フォーマット関数

コードの解説

多言語対応のための日付テキスト変換

言語ごとのテキスト設定

実装例：多言語対応の日付変換関数

コードの解説

日付フォーマットのユニットテストの書き方

PHPUnitのインストールと設定

ユニットテストの作成例

コードの解説

テストの実行

応用例：ブログ記事の投稿日をテキスト形式で表示する

データベースから取得した日付をフォーマットする

コードの解説

テンプレートエンジンとの統合

応用例の効果

トラブルシューティング：表示が正しくない場合の対策

問題1: タイムゾーン設定の不備

問題2: strtotime()が正しく動作しない

問題3: テキスト形式の表示が意図した通りでない

問題4: ロケール対応が不十分

デバッグと対策

まとめ

コメント

コメントする コメントをキャンセル

コメントするコメントをキャンセル