【PHP8.x】createFromISO8601Stringメソッドの使い方

createFromISO8601Stringメソッドの使い方について、初心者にもわかりやすく解説します。

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

基本的な使い方

createFromISO8601Stringメソッドは、ISO 8601形式の文字列からDatePeriodオブジェクトを生成するメソッドです。DatePeriodオブジェクトは、指定された開始日時、終了日時、そしてその間の期間（インターバル）に基づいて、一連の日時を反復処理するために用いられます。このメソッドを利用することで、複雑な日時計算を独自に行うことなく、国際標準であるISO 8601フォーマットで定義された期間を、DatePeriodオブジェクトとして簡単に扱えるようになります。

ISO 8601形式の期間文字列は、例えば「R5/2023-01-01T00:00:00Z/P1D」のように、繰り返し回数、開始日時、期間インターバルを一つの文字列で表現できます。createFromISO8601Stringメソッドは、このような標準形式の文字列を解析し、その情報をもとにDatePeriodオブジェクトを構築します。これにより、特定の期間にわたる毎日や毎月のイベントをループ処理する際などに、非常に直感的かつ簡潔にコードを記述することが可能になります。

このメソッドはPHP 8で導入され、日付と時刻の操作をより柔軟かつ強力にするための機能拡張の一つです。システムの設計において、繰り返し発生するイベントやタスクのスケジュール設定、レポート生成のための期間指定など、多岐にわたる場面でその有用性を発揮します。外部データソースや設定ファイルから期間情報を読み込む際にも、文字列から直接DatePeriodオブジェクトを生成できるため便利です。正しくISO 8601形式の文字列が与えられた場合に、このメソッドはDatePeriodオブジェクトを返します。

構文(syntax)


1<?php
2
3// ISO 8601形式の繰り返し期間文字列からDatePeriodオブジェクトを生成
4$isoString = "R5/2023-01-01T12:00:00Z/P7D";
5$datePeriod = DatePeriod::createFromISO8601String($isoString);
6
7?>

引数(parameters)

string $specification, int $options = 0

string $specification: ISO 8601 形式の期間指定文字列
int $options = 0: 期間の解析方法を指定するオプションフラグ

戻り値(return)

static

ISO 8601形式の文字列から、DatePeriodオブジェクトを生成します。