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

Copy
1<?php
2
3/**
4 * 現在の時刻をDATE_ISO8601_EXPANDED定数を使用してISO 8601拡張形式で出力します。
5 *
6 * この定数はPHP 8.0で導入され、ISO 8601形式の日付文字列を生成する際に、
7 * 5桁以上の年（拡張年）にも対応した形式を提供します。
8 */
9function showExpandedIso8601Date(): void
10{
11    // 現在の日付と時刻を表すDateTimeオブジェクトを作成
12    $now = new DateTime();
13
14    // DATE_ISO8601_EXPANDED 定数を用いてISO 8601拡張形式でフォーマット
15    $expandedIso8601Date = $now->format(DATE_ISO8601_EXPANDED);
16
17    echo "拡張ISO 8601形式の日付: " . $expandedIso8601Date . "\n";
18}
19
20// 関数を実行し、日付を出力
21showExpandedIso8601Date();
22

このサンプルコードは、PHPで現在の日付と時刻を特定の国際標準形式（ISO 8601拡張形式）で出力する方法を示しています。

DATE_ISO8601_EXPANDEDは、PHP 8.0で導入された特別な定数です。これはDateTimeクラスのformat()メソッドと組み合わせて使用され、日付を指定されたISO 8601形式の文字列に変換する役割を持ちます。この定数の特徴は、通常のISO 8601形式に加えて、西暦5桁以上の「拡張年」にも対応した形式で出力できる点にあります。DATE_ISO8601_EXPANDED定数自体には引数や戻り値はありません。これは、format()メソッドに渡すための、あらかじめ定義されたフォーマット指定文字列（内部的には、例えばY-m-d\TH:i:sPなど、ISO 8601拡張形式を表現する指示）だからです。

コードではまず、new DateTime()によって現在の日付と時刻を表すDateTimeオブジェクトが作成されます。次に、このオブジェクトのformat()メソッドが呼び出され、引数としてDATE_ISO8601_EXPANDEDが渡されます。format()メソッドは、この定数で指定された形式に従って日付文字列を生成し、その結果を文字列として返します。この返された文字列は$expandedIso8601Date変数に格納され、最終的にecho文で画面に出力されます。これにより、例えば「2023-10-27T10:30:00+09:00」のような、タイムゾーン情報を含む統一された形式の日付文字列が表示されます。

Copy
1<?php
2
3/**
4 * 現在の日付と時刻を ISO 8601 拡張形式でフォーマットします。
5 *
6 * この関数は DATE_ISO8601_EXPANDED 定数を利用して、
7 * ミリ秒とタイムゾーンオフセットを含む ISO 8601 拡張形式の文字列を生成します。
8 * 例: YYYY-MM-DDTHH:mm:ss.vvv+HH:MM
9 *
10 * @return string フォーマットされた日付時刻文字列
11 */
12function formatCurrentDateToIso8601Expanded(): string
13{
14    // 現在のタイムゾーンを設定して DateTime オブジェクトを作成します。
15    // 必要に応じて 'Asia/Tokyo' の部分を変更できます。
16    $dateTime = new DateTime('now', new DateTimeZone('Asia/Tokyo'));
17
18    // DATE_ISO8601_EXPANDED 定数を使って日付を ISO 8601 拡張形式にフォーマットします。
19    $formattedDate = $dateTime->format(DATE_ISO8601_EXPANDED);
20
21    return $formattedDate;
22}
23
24// 関数を実行し、フォーマットされた日付を出力します。
25echo "現在の日付を ISO 8601 拡張形式で表示:\n";
26echo formatCurrentDateToIso8601Expanded() . "\n";
27

このPHPコードは、現在の日付と時刻を「ISO 8601 拡張形式」という国際標準の形式で出力する方法を、システムエンジニアを目指す初心者の方にもわかりやすく示しています。

PHPのDATE_ISO8601_EXPANDED定数は、日付や時刻を特定の文字列形式に変換する際に用いられます。この定数を使用すると、ISO 8601形式の中でも、秒の小数点以下（ミリ秒など）とタイムゾーンオフセット（UTCからの時差）を含む、より詳細な日時表現が可能になります。具体的には、「YYYY-MM-DDTHH:mm:ss.vvv+HH:MM」のような形式で、例えば2023-10-27T10:30:45.123+09:00といった出力が期待されます。

サンプルコード内のformatCurrentDateToIso8601Expanded関数は引数をとりません。関数内部では、まずDateTimeクラスを使って現在の日時を表すオブジェクトを生成しています。ここでnew DateTimeZone('Asia/Tokyo')のようにタイムゾーンを指定することで、常に正確な地域の時刻を扱えるようになります。次に、このDateTimeオブジェクトのformat()メソッドにDATE_ISO8601_EXPANDED定数を渡すことで、指定されたISO 8601拡張形式に日時が変換された文字列が生成されます。この生成された文字列が、関数の戻り値として返されます。この定数を活用することで、システム間で日時情報を正確かつ一貫性のある形式でやり取りする際に非常に役立ちます。