【PHP8.x】DateTime::RFC1123定数の使い方

Copy
1<?php
2
3/**
4 * DateTime::RFC1123 定数を使用して現在の日時をRFC1123形式で表示するサンプルコードです。
5 *
6 * RFC1123形式は、インターネット標準の日付と時刻のフォーマットの一つであり、
7 * HTTPヘッダーなどでよく使用されます。
8 */
9
10// 1. 現在の日時を表すDateTimeオブジェクトを作成します。
11//    DateTimeクラスは、日付と時刻を操作するための機能を提供します。
12$currentDateTime = new DateTime();
13
14// 2. DateTime::RFC1123 定数を使用して日時をフォーマットします。
15//    この定数は、RFC1123形式に準拠した日付フォーマット文字列（例: "D, d M Y H:i:s T"）
16//    を内部的に保持しており、DateTimeオブジェクトのformat()メソッドに渡すことで
17//    指定された形式の日時文字列を得られます。
18$rfc1123FormattedString = $currentDateTime->format(DateTime::RFC1123);
19
20// 3. フォーマットされた日時文字列を出力します。
21echo "現在の日時をRFC1123形式で表示: " . $rfc1123FormattedString . "\n";
22
23// 参考: DateTime::RFC1123 定数自体がどのような文字列を保持しているかを確認できます。
24// これは、日付フォーマットを指定するための単なる文字列です。
25echo "DateTime::RFC1123 定数の値: " . DateTime::RFC1123 . "\n";

PHP 8のDateTime::RFC1123は、インターネット標準の日付と時刻のフォーマットの一つであるRFC1123形式を表す文字列定数です。この定数自体は引数を持たず、RFC1123形式（例: "D, d M Y H:i:s T"）の文字列値を返します。日時を特定のフォーマットで出力する際に、誤りのない標準形式を簡単に指定できるように定数として提供されています。

サンプルコードでは、まずnew DateTime()で現在の日時を表すDateTimeオブジェクトを作成します。次に、このDateTimeオブジェクトのformat()メソッドにDateTime::RFC1123定数を引数として渡します。format()メソッドは、この定数が示すRFC1123形式に従って日時を整形し、その結果を文字列として返します。RFC1123形式は、Webサーバーとクライアント間の通信で利用されるHTTPヘッダーなど、システム間で日時情報を交換する際に広く利用されており、この定数を使うことで、正確かつ手軽に標準的な日時表現を実現できます。

Copy
1<?php
2
3/**
4 * 現在の日時をRFC 1123形式でフォーマットし、出力します。
5 *
6 * RFC 1123形式は、HTTPヘッダーなどで使用される標準的な日付フォーマットの一つです。
7 * DateTime::RFC1123 定数を使用することで、この形式の文字列を簡単に取得できます。
8 * RFC 1123は、RFC 822の改訂版であり、非常に類似した形式を持ちます。
9 */
10function formatCurrentDateTimeAsRfc1123(): void
11{
12    // 現在の日時を表すDateTimeオブジェクトを作成します。
13    // 引数を指定しない場合、現在のローカル日時が設定されます。
14    $currentDateTime = new DateTime();
15
16    // DateTime::RFC1123 定数を使用して、RFC 1123形式で日付をフォーマットします。
17    // この定数は、"D, d M Y H:i:s T" のようなフォーマット文字列を保持しています。
18    $formattedString = $currentDateTime->format(DateTime::RFC1123);
19
20    // フォーマットされた日時を出力します。
21    echo "現在の日時をRFC 1123形式でフォーマット: " . $formattedString . "\n";
22}
23
24// 関数を実行して、サンプルコードの動作を確認します。
25formatCurrentDateTimeAsRfc1123();

このPHPサンプルコードは、現在の日時をRFC 1123という標準的な日付形式でフォーマットし、画面に出力するものです。RFC 1123は、ウェブ通信で利用されるHTTPヘッダーなどで広く使われる日付フォーマットの一つで、RFC 822を改訂した形式です。

まず、new DateTime() を使用して、現在のローカル日時を表す DateTime オブジェクトを作成します。このコンストラクタは引数を指定しない場合、実行時の現在日時でオブジェクトを初期化します。

次に、作成した DateTime オブジェクトの format() メソッドを呼び出します。この format() メソッドは、引数として渡されたフォーマット文字列に基づいて日時を整形し、その結果を文字列（string型）として返します。ここで利用している DateTime::RFC1123 は、DateTime クラスに定義されている定数で、RFC 1123形式を表すためのフォーマット文字列（例えば "D, d M Y H:i:s T"）を保持しています。この定数自体には引数はありません。

このようにしてRFC 1123形式にフォーマットされた日時文字列は $formattedString 変数に格納され、最後に echo 文によって画面に表示されます。サンプルコード全体は formatCurrentDateTimeAsRfc1123 という関数にまとめられており、この関数は引数を持たず、戻り値もありません（void）。DateTime::RFC1123 定数を使用することで、標準的な日付フォーマットを簡単に、かつ正確に取得できる点がこのコードの利便性です。