Kaedah format kelas DateInterval

Kaedah format kelas DateInterval menukar selang waktu kepada perwakilan rentetan mengikut format yang dinyatakan. Ia menerima rentetan format yang mengandungi aksara khas sebagai parameter dan mengembalikan rentetan yang diformat.

Sintaks

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

Aksara Khas

Penyepesifikasi	Penerangan	Contoh
`%Y`	Bilangan tahun (minimum `2 digit)`	01, 12
`%y`	Bilangan tahun (tanpa penambahan sifar)	1, 12
`%M`	Bilangan bulan (minimum `2 digit)`	01, 11
`%m`	Bilangan bulan (tanpa penambahan sifar)	1, 11
`%D`	Bilangan hari (minimum `2 digit)`	01, 31
`%d`	Bilangan hari (tanpa penambahan sifar)	1, 31
`%H`	Bilangan jam (minimum `2 digit)`	01, 23
`%h`	Bilangan jam (tanpa penambahan sifar)	1, 23
`%I`	Bilangan minit (minimum `2 digit)`	01, 59
`%i`	Bilangan minit (tanpa penambahan sifar)	1, 59
`%S`	Bilangan saat (minimum `2 digit)`	01, 59
`%s`	Bilangan saat (tanpa penambahan sifar)	1, 59
`%R`	Tanda selang (+ atau -)	+, -
`%r`	Tanda selang dengan nyatakan jelas (- jika negatif)	, -
`%%`	Aksara peratus	%

Contoh

Memformat selang dalam hari dan jam:

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

Keputusan pelaksanaan kod:

'2 days, 5 hours'

Contoh

Memformat selang dalam perwakilan penuh:

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

Keputusan pelaksanaan kod:

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

Contoh

Memformat selang dengan sifar pendahulu:

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

Keputusan pelaksanaan kod:

'05:03'

Lihat juga

kelas DateInterval,
yang mewakili selang waktu
kaedah DateTime::format,
yang memformat tarikh dan masa
fungsi date,
yang memformat capaian masa