【PHP8.x】DateError::messageプロパティの使い方

Copy
1<?php
2
3/**
4 * 不正な日付文字列を処理し、DateError::message プロパティの使用例を示す関数。
5 *
6 * システムエンジニアを目指す初心者向けに、日付処理におけるエラーハンドリングと
7 * PHP 8 で導入された DateError クラスからエラーメッセージを取得する方法を実演します。
8 * DateTimeImmutable/DateTime クラスのコンストラクタに不正な日付文字列が渡された場合、
9 * DateError 例外がスローされます。この例外の `message` プロパティから、
10 * エラー内容を簡潔な文字列として取得できます。
11 *
12 * @param string $dateString 処理を試みる日付文字列
13 */
14function demonstrateDateErrorHandling(string $dateString): void
15{
16    echo "日付文字列 '{$dateString}' の処理を試行中...\n";
17
18    try {
19        // 不正な日付文字列が渡された場合、ここで DateError が発生する可能性がある
20        $date = new DateTimeImmutable($dateString);
21        echo "  成功: 日付を '{$date->format('Y-m-d H:i:s')}' として解析しました。\n";
22    } catch (DateError $e) {
23        // DateError が捕捉された場合、その message プロパティからエラーメッセージを取得
24        echo "  日付処理エラーが発生しました: " . $e->message . "\n";
25        echo "  (エラーコード: " . $e->getCode() . ")\n";
26    } catch (Throwable $e) {
27        // その他の予期せぬエラーを捕捉（DateError は Throwable の一種）
28        echo "  予期せぬエラーが発生しました: " . $e->getMessage() . "\n";
29    }
30    echo "--------------------------------------------------\n";
31}
32
33// --- サンプル実行 ---
34
35// 1. 正常な日付文字列の例
36demonstrateDateErrorHandling("2023-10-27 15:30:00");
37
38// 2. 不正なフォーマットの日付文字列の例 (DateError が発生)
39demonstrateDateErrorHandling("invalid-date-format");
40
41// 3. 存在しない日付の例 (DateError が発生)
42demonstrateDateErrorHandling("2023-02-30");
43
44// 4. 不完全な日付文字列の例 (DateError が発生)
45demonstrateDateErrorHandling("2024-04");

DateError::messageは、PHP 8から導入されたDateErrorクラスが持つプロパティで、日付や時刻の処理中に発生したエラーの具体的な内容を文字列として提供します。このプロパティは引数を取らず、エラーメッセージを表す文字列を返します。

このサンプルコードは、PHPで日付処理を行う際のエラーハンドリングとDateError::messageプロパティの利用方法を示しています。DateTimeImmutableやDateTimeクラスのコンストラクタに「invalid-date-format」や「2023-02-30」のような不正な日付文字列が渡された場合、DateError例外がスローされます。

try-catchブロックを用いることで、このDateError例外を捕捉し、捕捉した例外オブジェクトの$e->messageプロパティから、具体的なエラー内容を簡潔な文字列として取得し表示しています。これにより、プログラムが不正な日付入力を受けた際に、何が問題だったのかを正確にユーザーに伝えたり、ログに記録したりするのに役立ちます。日付関連のエラーを効果的に処理するための基本的なアプローチとして理解してください。