Metoda format klasy DateInterval

Metoda format klasy DateInterval przekształca przedział czasowy na reprezentację ciągu znaków zgodnie z określonym formatem. Jako parametr przyjmuje ciąg formatujący, zawierający specjalne symbole, i zwraca sformatowany ciąg znaków.

Składnia

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

Specjalne symbole

Specyfikator	Opis	Przykład
`%Y`	Liczba lat (co najmniej `2 cyfry)`	01, 12
`%y`	Liczba lat (bez wypełniania zerami)	1, 12
`%M`	Liczba miesięcy (co najmniej `2 cyfry)`	01, 11
`%m`	Liczba miesięcy (bez wypełniania zerami)	1, 11
`%D`	Liczba dni (co najmniej `2 cyfry)`	01, 31
`%d`	Liczba dni (bez wypełniania zerami)	1, 31
`%H`	Liczba godzin (co najmniej `2 cyfry)`	01, 23
`%h`	Liczba godzin (bez wypełniania zerami)	1, 23
`%I`	Liczba minut (co najmniej `2 cyfry)`	01, 59
`%i`	Liczba minut (bez wypełniania zerami)	1, 59
`%S`	Liczba sekund (co najmniej `2 cyfry)`	01, 59
`%s`	Liczba sekund (bez wypełniania zerami)	1, 59
`%R`	Znak przedziału (+ lub -)	+, -
`%r`	Znak przedziału z jawnym wskazaniem (- przy ujemnym)	, -
`%%`	Symbol procentu	%

Przykład

Formatowanie przedziału w dniach i godzinach:

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

Wynik wykonania kodu:

'2 days, 5 hours'

Przykład

Formatowanie przedziału w pełnej reprezentacji:

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

Wynik wykonania kodu:

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

Przykład

Formatowanie przedziału z wiodącymi zerami:

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

Wynik wykonania kodu:

'05:03'

Zobacz także

klasę DateInterval,
która reprezentuje przedział czasowy
metodę DateTime::format,
która formatuje datę i czas
funkcję date,
która formatuje znacznik czasu