More than 5 years have passed since last update.

PHPのDateTime::ISO8601はISO8601ではない

Posted at 2019-01-09

前提

以下のバージョンにおける情報です。

PHPには DateTime::ISO8601 という定義済み定数があります。
この定義済み定数を利用して、以下のようなコードでフォーマットされた日付の文字列を取得できます。

$date = new DateTime();
echo $date->format(DateTime::ISO8601); // 2019-01-09T14:20:03+0000

上のコードを実行すると 2019-01-09T14:20:03+0000 のような文字列を取得できます。

DateTime::ISO8601 を指定して取得された文字列なので、ISO8601 に互換性があることを期待したのですが、なんと互換性はありません。

ISO8601 が規定している形式とは異なってしまっています。

では、ISO8601とどう異なっているのでしょうか。

ISO8601には「基本形式」と「拡張形式」の２種類の形式があります。
それぞれ以下のようなものです。

形式	表記
基本形式	20190109T142003+0000
拡張形式	2019-01-09T14:20:03+00:00

一見、 DateTime::ISO8601 で得られる文字列は「拡張形式」のように見えますが、よく見るとタイムゾーンの表記が異なります。

拡張形式のタイムゾーンにはコロンが入りますが、 DateTime::ISO8601 で得られる文字列にはコロンが入っていません。

よって、基本形式と拡張形式のどちらにも互換性のない文字列となってしまっています。

このISO8601に互換性のない文字列をPHP内だけで扱う場合には問題は起きないかもしれません。
しかし、APIなど外部と連携するプログラムを書く場合には注意が必要です。

APIレスポンスとして受信した側が、この文字列を日時としてパースできない可能性があるからです。

JavaScriptでは一部のブラウザで、パースできない問題があります。
APIをPHPで構築しフロントエンドのJavaScriptでそれを呼び出す、というシチュエーションは多くあるので要注意です。

new Date('2019-01-09T14:20:03+0000')

Ruby 2.4.0で試したところ、パース可能でした。

DateTime.parse('2019-01-09T14:20:03+0000')

Python 3.6.2で試したところ、パース可能でした。

from dateutil.parser import parse
parse('2019-01-09T14:20:03+0000')

では、 ISO8601 に互換性のあるフォーマットの日時文字列を取得したい場合はどうしたらいいでしょうか。

その場合には　DateTime::ISO8601 ではなく DateTime::ATOM を使用します。

$date = new DateTime();
echo $date->format(DateTime::ATOM); // 2019-01-09T14:20:03+00:00

上のコードでは、 2019-01-09T14:20:03+00:00 のようなISO8601の拡張形式に互換性のある文字列が取得できます。