Метод 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,
която форматира времева марка