(PHP 8 >= 8.3.0)
DatePeriod::createFromISO8601String — Создаёт новый объект DatePeriod из строки в формате стандарта ISO8601
Создаёт новый объект DatePeriod из строки в формате стандарта ISO8601, как указано в параметре specification
.
specification
Подмножество » спецификации повторяющихся интервалов стандарта ISO 8601.
Пример принимаемой спецификации интервала стандарта ISO 8601 — это строка R5/2008-03-01T13:00:00Z/P1Y2M10DT2H30M
, которая указывает:
R5/
) 2008-03-01T13:00:00Z
. /P1Y2M10DT2H30M
). Примеры спецификации интервалов стандарта ISO 8601, которые PHP не поддерживает:
R0/
) Z
), например, +02:00
. options
Битовое поле, которое можно указывать для управления отдельным поведением с начальными и конечными датами.
Константа DatePeriod::EXCLUDE_START_DATE
исключает дату начала из набора повторяющихся дат в пределах периода.
Константа DatePeriod::INCLUDE_END_DATE
включает дату окончания в наборе повторяющихся дат в пределах периода.
Возвращает созданный объект DatePeriod.
С объектом, созданным этим методом DatePeriod, можно работать как с итератором, чтобы создавать объекты DateTimeImmutable.
Выбрасывает исключение DateMalformedPeriodStringException, если значение параметра specification
не может быть разобрано как допустимое значение периода в формате стандарта ISO 8601.
Пример #1 Пример использования метода DatePeriod::createFromISO8601String
<?php
$iso = 'R4/2023-07-01T00:00:00Z/P7D';
$period = DatePeriod::createFromISO8601String($iso);
// При переборе объекта DatePeriod будут напечатаны
// повторяющиеся в пределах периода даты.
foreach ($period as $date) {
echo $date->format('Y-m-d'), "\n";
}
?>
Результат выполнения приведённого примера:
2023-07-01 2023-07-08 2023-07-15 2023-07-22 2023-07-29