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

Copy
1<?php
2
3/**
4 * 現在の日時をRFC2822形式でフォーマットする例。
5 *
6 * DateTimeImmutable::RFC2822 定数を利用して、現在の日時を
7 * インターネットメッセージで一般的に使われるRFC2822形式の文字列に変換します。
8 */
9function displayRfc2822FormattedDateTime(): void
10{
11    // 現在の日時を表すDateTimeImmutableオブジェクトを生成します。
12    // DateTimeImmutableは、作成後に状態が変更されない日付/時刻オブジェクトです。
13    $now = new DateTimeImmutable();
14
15    // DateTimeImmutable::RFC2822 定数を使って、
16    // $now オブジェクトが持つ日時情報をRFC2822形式の文字列にフォーマットします。
17    // この定数は、"D, d M Y H:i:s O" のフォーマット文字列に相当します。
18    $rfc2822Date = $now->format(DateTimeImmutable::RFC2822);
19
20    // フォーマットされた日付と時刻を出力します。
21    echo "現在の日時 (RFC2822形式): " . $rfc2822Date . PHP_EOL;
22}
23
24// 定義した関数を実行し、結果を表示します。
25displayRfc2822FormattedDateTime();
26
27?>

このサンプルコードは、PHPのDateTimeImmutableクラスを使用して、現在の日時をRFC2822形式でフォーマットする方法を示しています。RFC2822は、インターネットメッセージで一般的に使用される日付と時刻の形式です。

まず、DateTimeImmutableクラスのインスタンスを作成し、現在の日時を表すオブジェクト $now を生成します。DateTimeImmutableは、一度作成されると変更できない日付/時刻オブジェクトです。

次に、$now オブジェクトの format() メソッドを使用し、日時を指定された形式に変換します。format() メソッドの引数には、DateTimeImmutable::RFC2822 定数を指定します。この定数は、RFC2822形式に対応する定義済みのフォーマット文字列（"D, d M Y H:i:s O"）を表します。format() メソッドは、フォーマットされた日付と時刻の文字列を返します。

最後に、フォーマットされた日付と時刻の文字列を画面に出力します。この例では、displayRfc2822FormattedDateTime() 関数を定義し、その中で日付のフォーマットと出力を行っています。DateTimeImmutable::RFC2822 定数を利用することで、複雑なフォーマット文字列を記述することなく、簡単にRFC2822形式の日付文字列を取得できます。戻り値はフォーマットされた日付文字列です。