Metoda format třídy DateInterval

Metoda format třídy DateInterval převádí časový interval do řetězcové reprezentace podle zadaného formátu. Jako parametr přijímá řetězec formátu obsahující speciální symboly a vrací naformátovaný řetězec.

Syntaxe

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

Speciální symboly

Specifikátor	Popis	Příklad
`%Y`	Počet let (minimálně `2 číslice)`	01, 12
`%y`	Počet let (bez doplnění nulami)	1, 12
`%M`	Počet měsíců (minimálně `2 číslice)`	01, 11
`%m`	Počet měsíců (bez doplnění nulami)	1, 11
`%D`	Počet dní (minimálně `2 číslice)`	01, 31
`%d`	Počet dní (bez doplnění nulami)	1, 31
`%H`	Počet hodin (minimálně `2 číslice)`	01, 23
`%h`	Počet hodin (bez doplnění nulami)	1, 23
`%I`	Počet minut (minimálně `2 číslice)`	01, 59
`%i`	Počet minut (bez doplnění nulami)	1, 59
`%S`	Počet sekund (minimálně `2 číslice)`	01, 59
`%s`	Počet sekund (bez doplnění nulami)	1, 59
`%R`	Znaménko intervalu (+ nebo -)	+, -
`%r`	Znaménko intervalu s explicitním uvedením (- při záporném)	, -
`%%`	Symbol procenta	%

Příklad

Formátování intervalu ve dnech a hodinách:

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

Výsledek provedení kódu:

'2 days, 5 hours'

Příklad

Formátování intervalu v plném vyjádření:

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

Výsledek provedení kódu:

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

Příklad

Formátování intervalu s úvodními nulami:

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

Výsledek provedení kódu:

'05:03'

Viz také

třída DateInterval,
která reprezentuje časový interval
metoda DateTime::format,
která formátuje datum a čas
funkce date,
která formátuje časové razítko