DateInterval klassi meetod format

Meetod format klassist DateInterval teisendab ajavahemiku string-esituseks vastavalt määratud vormingule. Parameetrina võtab ta vormingu stringi, mis sisaldab spetsiaalseid sümboleid, ja tagastab vormindatud stringi.

Süntaks

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

Spetsiaalsed sümbolid

Spetsifikaator	Kirjeldus	Näide
`%Y`	Aastate arv (vähemalt `2 numbrit)`	01, 12
`%y`	Aastate arv (ilma nullidega täitmiseta)	1, 12
`%M`	Kuude arv (vähemalt `2 numbrit)`	01, 11
`%m`	Kuude arv (ilma nullidega täitmiseta)	1, 11
`%D`	Päevade arv (vähemalt `2 numbrit)`	01, 31
`%d`	Päevade arv (ilma nullidega täitmiseta)	1, 31
`%H`	Tundide arv (vähemalt `2 numbrit)`	01, 23
`%h`	Tundide arv (ilma nullidega täitmiseta)	1, 23
`%I`	Minutite arv (vähemalt `2 numbrit)`	01, 59
`%i`	Minutite arv (ilma nullidega täitmiseta)	1, 59
`%S`	Sekundite arv (vähemalt `2 numbrit)`	01, 59
`%s`	Sekundite arv (ilma nullidega täitmiseta)	1, 59
`%R`	Intervalli märk (+ või -)	+, -
`%r`	Intervalli märk koos selge märgistusega (- negatiivsel juhul)	, -
`%%`	Protsendi sümbol	%

Näide

Intervalli vormindamine päevades ja tundides:

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

Koodi täitmise tulemus:

'2 days, 5 hours'

Näide

Intervalli vormindamine täies esituses:

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

Koodi täitmise tulemus:

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

Näide

Intervalli vormindamine eesolevate nullidega:

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

Koodi täitmise tulemus:

'05:03'

Vaata ka

klass DateInterval,
mis esindab ajavahemikku
meetod DateTime::format,
mis vormindab kuupäeva ja kellaaega
funktsioon date,
mis vormindab ajatempli