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

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

作成日: 2025年09月11日更新日: 2025年10月19日

基本的な使い方

RFC3339定数は、インターネット上で日付と時刻を標準的な形式で表現するためのフォーマット文字列を保持する定数です。PHPのDateTimeImmutableクラス（およびDateTimeクラス）のメソッド、特にformat()メソッドで使用することを想定されており、RFC3339という国際的な標準規格に準拠した文字列を簡単に生成するために役立ちます。

この定数を使用することで、開発者は複雑な日付フォーマット文字列（例: 'Y-m-d\TH:i:sP'）を直接覚える必要がなく、単にDateTime::RFC3339を指定するだけで、自動的に標準的な形式に変換できます。これにより、日付時刻のフォーマットに関する入力ミスを防ぎ、記述の手間を省くことができます。

RFC3339形式は、ISO 8601に基づいた日付と時刻の表現方法であり、ウェブサービスやAPIなど、異なるシステム間で日付時刻情報を安全かつ正確に交換する際に広く利用されています。この形式は、日付、時刻、そしてタイムゾーンオフセット（例: +09:00）を明確に含んでいるため、世界のどこからアクセスしても、時刻がいつであったかを一意に特定できる点が重要です。

例えば、new DateTimeImmutable('now')で現在時刻のオブジェクトを作成し、format(DateTime::RFC3339)を実行すると、2023-10-27T10:30:00+09:00のような形式の文字列が得られます。このように、RFC3339定数は、日付時刻処理において、標準に準拠した堅牢なシステムを構築するための基盤を提供する重要な要素です。

構文(syntax)


1echo DateTimeImmutable::RFC3339;

引数(parameters)

戻り値(return)

string

RFC3339定数は、RFC 3339で定義された日付・時刻フォーマットを表す文字列を返します。このフォーマットは、YYYY-MM-DDTHH:MM:SS.s+HH:MMの形式です。

サンプルコード

DateTimeImmutable::RFC3339_EXTENDED で日時をフォーマットする


1<?php
2
3// DateTimeImmutable::RFC3339 は、RFC3339 形式の日付時刻を表す定数です。
4// DateTimeImmutable::RFC3339_EXTENDED は、RFC3339 拡張形式の日付時刻を表す定数です。
5
6// 現在の日時を RFC3339 拡張形式で取得する例
7$date = new DateTimeImmutable();
8$rfc3339Extended = $date->format(DateTimeImmutable::RFC3339_EXTENDED);
9
10// 結果を出力
11echo "RFC3339 Extended フォーマット: " . $rfc3339Extended . PHP_EOL;
12
13?>

このサンプルコードは、PHPで現在の日時を「RFC3339 拡張形式」という世界標準の書式で、かつ高精度な文字列として取得する方法を示しています。

まず new DateTimeImmutable() を使い、現在の日時情報を持つ変更不可能なオブジェクトを生成します。DateTimeImmutable クラスは、一度作成するとその日時を変更できないため、安全に日時データを扱うことができます。

次に、生成した日時オブジェクトの format() メソッドを呼び出します。このメソッドは、引数で指定された書式に従って日時を文字列に変換し、その結果を戻り値として返します。

ここで引数として指定している DateTimeImmutable::RFC3339_EXTENDED は、PHPにあらかじめ定義されている定数です。これは「年-月-日T時:分:秒.マイクロ秒+タイムゾーン」という、マイクロ秒（100万分の1秒）まで含む非常に詳細な書式を表します。似た定数に DateTimeImmutable::RFC3339 がありますが、こちらは秒までの形式です。

最後に、format() メソッドから返された文字列を出力しています。この高精度な日時形式は、APIでのデータ交換や、システムの詳細なログを記録する際などに非常に役立ちます。

DateTimeImmutable::RFC3339_EXTENDEDは、日付時刻をRFC3339拡張形式の文字列で表現するための定数です。DateTimeImmutableオブジェクトのformat()メソッドで使用することで、希望する形式で日付時刻を文字列に変換できます。この定数は、ISO 8601形式を基にしており、より詳細な秒の小数点以下の桁数を表現できます。

注意点として、format()メソッドに渡す際に定数を間違えないようにしましょう。また、DateTimeImmutableはimmutableなオブジェクトなので、日付時刻を変更する操作は新しいオブジェクトを生成します。元のオブジェクトは変更されない点に注意してください。RFC3339_EXTENDEDを使うと、生成される文字列が長くなる可能性があることも考慮しましょう。