A DateInterval osztály format metódusa

A format metódus a DateInterval osztályban egy időintervallumot sztring reprezentációvá alakít a megadott formátumnak megfelelően. Paraméterként egy formátumot tartalmazó sztringet fogad, amely speciális karaktereket tartalmaz, és visszaad egy formázott sztringet.

Szintaxis

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

Speciális karakterek

Specifikátor	Leírás	Példa
`%Y`	Évek száma (minimum `2 számjegy)`	01, 12
`%y`	Évek száma (nulla kitöltés nélkül)	1, 12
`%M`	Hónapok száma (minimum `2 számjegy)`	01, 11
`%m`	Hónapok száma (nulla kitöltés nélkül)	1, 11
`%D`	Napok száma (minimum `2 számjegy)`	01, 31
`%d`	Napok száma (nulla kitöltés nélkül)	1, 31
`%H`	Órák száma (minimum `2 számjegy)`	01, 23
`%h`	Órák száma (nulla kitöltés nélkül)	1, 23
`%I`	Percek száma (minimum `2 számjegy)`	01, 59
`%i`	Percek száma (nulla kitöltés nélkül)	1, 59
`%S`	Másodpercek száma (minimum `2 számjegy)`	01, 59
`%s`	Másodpercek száma (nulla kitöltés nélkül)	1, 59
`%R`	Az intervallum előjele (+ vagy -)	+, -
`%r`	Az intervallum előjele explicit módon (- negatív esetén)	, -
`%%`	Százalék jel	%

Példa

Intervallum formázása napokban és órákban:

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

A kód végrehajtásának eredménye:

'2 days, 5 hours'

Példa

Intervallum formázása teljes reprezentációban:

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

A kód végrehajtásának eredménye:

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

Példa

Intervallum formázása vezető nullákkal:

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

A kód végrehajtásának eredménye:

'05:03'

Lásd még

a DateInterval osztály,
amely egy időintervallumot reprezentál
a DateTime::format metódus,
amely formázza a dátumot és időt
a date függvény,
amely formáz egy időbélyeget