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

Copy
1<?php
2
3/**
4 * 現在の日時をRFC 1123形式とRFC 3339形式で表示する関数。
5 *
6 * DATE_RFC1123とDATE_RFC3339は、date()関数やDateTime::format()メソッドで
7 * 標準的な日付/時刻形式を生成するためのPHP定数です。
8 */
9function displayRfcFormattedDates(): void
10{
11    // 現在の日時を表すDateTimeオブジェクトを作成
12    $currentDateTime = new DateTime();
13
14    // RFC 1123 形式で日時を出力 (HTTP Dateヘッダーなどで使用される形式)
15    // 例: Mon, 15 Aug 2005 15:12:46 GMT
16    $rfc1123_date = $currentDateTime->format(DATE_RFC1123);
17    echo "RFC 1123 形式: " . $rfc1123_date . PHP_EOL;
18
19    // RFC 3339 形式で日時を出力 (APIのデータ交換などで広く使用される形式)
20    // 例: 2005-08-15T15:12:46+00:00
21    $rfc3339_date = $currentDateTime->format(DATE_RFC3339);
22    echo "RFC 3339 形式: " . $rfc3339_date . PHP_EOL;
23}
24
25// 定義した関数を実行
26displayRfcFormattedDates();

このPHPサンプルコードは、現在の日時を国際的な標準形式であるRFC 1123形式とRFC 3339形式で表示する方法を紹介しています。

DATE_RFC1123やDATE_RFC3339は、PHPに標準で用意されている特別な「定数」です。これらの定数は、それぞれ特定の日付時刻フォーマットを表す文字列を値として持っており、その型は文字列（string）です。これらの定数自体には引数はありません。

まず、new DateTime()を使って現在の日時を表すDateTimeオブジェクトを作成します。次に、この$currentDateTimeオブジェクトのformat()メソッドを利用し、引数としてDATE_RFC1123定数を渡します。すると、HTTPヘッダーなどで使われる「Mon, 15 Aug 2005 15:12:46 GMT」のような形式の文字列が戻り値として得られます。

同様に、DATE_RFC3339定数をformat()メソッドの引数として渡すことで、Web APIのデータ交換などで広く利用される「2005-08-15T15:12:46+00:00」のような形式の文字列が戻り値として得られます。

このように、これらの定数を活用することで、複雑な日付フォーマットの書式を直接記述することなく、標準的な形式の文字列を簡単に生成できます。これにより、異なるシステム間での日付時刻のやり取りを円滑に行うことができます。

Copy
1<?php
2
3/**
4 * 現在の時刻を RFC 1123 形式 (HTTP ヘッダーなどで使用される標準形式) で取得し、表示します。
5 * DATE_RFC1123 定数は、この特定の日付フォーマットを表す文字列 ("D, d M Y H:i:s T") です。
6 *
7 * このコードは、date() 関数と組み合わせて定数を使用する方法を示しています。
8 * システムエンジニアを目指す方にとって、日付・時刻のフォーマットはログ記録やAPI連携で頻繁に登場するため重要です。
9 */
10function displayCurrentTimeInRfc1123Format(): void
11{
12    // DATE_RFC1123 定数を使用して、現在の時刻を RFC 1123 形式にフォーマットします。
13    // 例: "Wed, 23 Jun 2021 10:30:00 GMT"
14    $formattedDate = date(DATE_RFC1123);
15
16    // フォーマットされた日付文字列を出力します。
17    echo "現在の時刻 (RFC 1123形式): " . $formattedDate . PHP_EOL;
18}
19
20// 関数を呼び出し、処理を実行します。
21displayCurrentTimeInRfc1123Format();
22
23?>

PHP 8で提供されるDATE_RFC1123は、特定の日付時刻フォーマットを表す組み込み定数です。この定数は、WebサーバーのHTTPヘッダーやAPI連携などで広く利用されるRFC 1123（またはRFC 822）形式に準拠した日付フォーマットを指定するために使用されます。

DATE_RFC1123定数自体は引数を取らず、その値として"D, d M Y H:i:s T"という文字列を保持しています。このため、サンプルコードのようにPHPのdate()関数にこの定数を引数として渡すことで、現在の時刻を「Wed, 23 Jun 2021 10:30:00 GMT」のようなRFC 1123形式の文字列に容易に変換できます。date()関数は、指定されたフォーマット文字列に従って（デフォルトでは現在の時刻の）UNIXタイムスタンプを整形し、その結果を文字列として返します。

システムエンジニアを目指す方にとって、日付や時刻のフォーマットは、システムのログ記録、APIからのデータ送受信、キャッシュ制御など、多岐にわたる場面で正確な処理が求められる重要な要素です。DATE_RFC1123のような標準的な定数を利用することで、国際的な基準に則った統一された形式で日付時刻を扱えるため、異なるシステム間の互換性を保ちやすくなります。