【PHP8.x】DateTimeInterface::RFC3339_EXTENDED定数の使い方

RFC3339_EXTENDED定数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年02月11日

基本的な使い方

RFC3339_EXTENDED定数は、日付と時刻を標準的なフォーマットで表現するための文字列を表す定数です。この定数は、特にPHPのDateTimeクラスやDateTimeImmutableクラスといった、DateTimeInterfaceを実装する日付・時刻を扱う機能と組み合わせて使用されます。

この定数が表すフォーマットは、国際的な日付時刻の標準であるISO 8601に基づいた「RFC 3339」形式を拡張したものです。具体的には、「YYYY-MM-DDTHH:MM:SS.vP」のような形式で、年、月、日、時、分、秒に加えて、ミリ秒やマイクロ秒といった高精度な小数秒、そしてタイムゾーン情報までを含んでいます。標準のRFC 3339形式では秒の小数点以下はオプションでしたが、RFC3339_EXTENDEDではこれを明確にサポートし、より詳細な時刻表現を可能にしています。

システムエンジニアとして、異なるシステム間で日付時刻データを交換する際には、統一された形式を用いることが非常に重要です。このRFC3339_EXTENDED形式は、Web APIのJSONデータやXMLデータなどで日付時刻をやり取りする際の推奨フォーマットの一つとして広く利用されています。

PHPでこの定数を使用すると、DateTimeオブジェクトのformat()メソッドに渡すことで、指定された形式の日付時刻文字列を簡単に生成できます。また、DateTime::createFromFormat()メソッドで、この形式の文字列からDateTimeオブジェクトを生成する際にも利用でき、日付時刻のパース（解析）処理を簡潔かつ正確に行うことができます。この定数を利用することで、日付時刻のフォーマットに関する手間を省き、システム間の連携におけるエラーを減らすことにも繋がります。

構文(syntax)


1<?php
2
3$datetime = new DateTime();
4echo $datetime->format(DateTimeInterface::RFC3339_EXTENDED);
5
6?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

戻り値なし

戻り値はありません

サンプルコード

PHPのRFC3339_EXTENDED形式で日時を取得する


1<?php
2
3/**
4 * 現在の日時を RFC3339_EXTENDED 形式で取得し、出力する関数です。
5 *
6 * このフォーマットは、RFC 3339 の拡張版で、ミリ秒/マイクロ秒の精度を含む日付と時刻を提供します。
7 * DateTime::format() メソッドと共に使用することで、指定された形式で日付文字列を生成できます。
8 */
9function displayExtendedRfc3339Date(): void
10{
11    // 現在の日時を表すDateTimeオブジェクトを作成します。
12    $dateTime = new DateTime();
13
14    // DateTimeInterface::RFC3339_EXTENDED 定数を使用して、
15    // 日付と時刻をRFC 3339拡張形式（ミリ秒/マイクロ秒精度）でフォーマットします。
16    $formattedDate = $dateTime->format(DateTimeInterface::RFC3339_EXTENDED);
17
18    // フォーマットされた日付と時刻を出力します。
19    echo "RFC3339_EXTENDED 形式の日付と時刻: " . $formattedDate . PHP_EOL;
20}
21
22// 上記の関数を実行します。
23displayExtendedRfc3339Date();

DateTimeInterface::RFC3339_EXTENDEDは、PHP 8以降で利用できるDateTimeInterfaceインターフェースが提供する重要な定数です。この定数は、日付と時刻をISO 8601に基づいたRFC 3339の拡張形式で表現するための文字列フォーマット指定子として機能します。RFC 3339_EXTENDED形式では、通常のRFC 3339に加えてミリ秒やマイクロ秒といった高精度な時間情報も含まれるため、より詳細で厳密な時刻表現が可能となります。

この定数は、主にDateTimeクラスのformat()メソッドに引数として渡して使用されます。format()メソッドは、この定数が保持するフォーマット文字列に基づいて、DateTimeオブジェクトが表す日付と時刻を高精度な文字列に変換します。この定数自体に引数はなく、呼び出し元に値を返しませんが、その「値」であるフォーマット文字列がformat()メソッドの挙動を制御します。

サンプルコードでは、まずnew DateTime()で現在の日時を表すDateTimeオブジェクトを作成しています。次に、このオブジェクトのformat()メソッドにDateTimeInterface::RFC3339_EXTENDED定数を指定することで、現在の日時をミリ秒/マイクロ秒精度を含むRFC 3339拡張形式の文字列として取得し、コンソールに出力しています。高精度なタイムスタンプが必要なログ管理や、異なるシステム間での厳密な時刻同期が求められるAPI連携など、システム開発の様々な場面で活用できるでしょう。

このRFC3339_EXTENDED定数はPHP 8で追加されたため、それ以前のバージョンでは利用できませんのでご注意ください。この定数は、ミリ秒やマイクロ秒を含む高精度な日付時刻形式を簡単に指定できる便利な定数です。DateTime::format()メソッドと組み合わせて利用することで、国際標準であるRFC 3339に準拠した拡張形式で日付文字列を生成できます。特に、高精度な時刻情報を必要とするシステム連携やログ出力に適しています。直接文字列でフォーマットを指定するよりも、この定数を使うことでスペルミスを防ぎ、より安全で可読性の高いコードになります。