Метод format класса DateInterval

Метод format класса DateInterval преобразует временной интервал в строковое представление согласно указанному формату. В качестве параметра принимает строку формата, содержащую специальные символы, и возвращает отформатированную строку.

Синтаксис

public DateInterval::format(string $format): string

Специальные символы

Спецификатор	Описание	Пример
`%Y`	Количество лет (минимум `2 цифры)`	01, 12
`%y`	Количество лет (без дополнения нулями)	1, 12
`%M`	Количество месяцев (минимум `2 цифры)`	01, 11
`%m`	Количество месяцев (без дополнения нулями)	1, 11
`%D`	Количество дней (минимум `2 цифры)`	01, 31
`%d`	Количество дней (без дополнения нулями)	1, 31
`%H`	Количество часов (минимум `2 цифры)`	01, 23
`%h`	Количество часов (без дополнения нулями)	1, 23
`%I`	Количество минут (минимум `2 цифры)`	01, 59
`%i`	Количество минут (без дополнения нулями)	1, 59
`%S`	Количество секунд (минимум `2 цифры)`	01, 59
`%s`	Количество секунд (без дополнения нулями)	1, 59
`%R`	Знак интервала (+ или -)	+, -
`%r`	Знак интервала с явным указанием (- при отрицательном)	, -
`%%`	Символ процента	%

Пример

Форматирование интервала в днях и часах:

<?php
	$interval = new DateInterval('P2DT5H');
	echo $interval->format('%d days, %h hours');
?>

Результат выполнения кода:

'2 days, 5 hours'

Пример

Форматирование интервала в полном представлении:

<?php
	$interval = new DateInterval('P1Y3M5DT7H10M');
	echo $interval->format('%y years %m months %d days %h hours %i minutes');
?>

Результат выполнения кода:

'1 years 3 months 5 days 7 hours 10 minutes'

Пример

Форматирование интервала с ведущими нулями:

<?php
	$interval = new DateInterval('PT5H3M');
	echo $interval->format('%H:%I');
?>

Результат выполнения кода:

'05:03'

Смотрите также

класс DateInterval,
который представляет временной интервал
метод DateTime::format,
который форматирует дату и время
функцию date,
которая форматирует временную метку