DateInterval-luokan format-metodi

DateInterval-luokan format-metodi muuntaa aikavälin merkkijonoesitykseksi määritetyn muotoilun mukaisesti. Se ottaa parametrina muotoilumerkkijonon, joka sisältää erikoismerkkejä, ja palauttaa muotoillun merkkijonon.

Syntaksi

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

Erikoismerkit

Spesifioija	Kuvaus	Esimerkki
`%Y`	Vuosien määrä (vähintään `2 numeroa)`	01, 12
`%y`	Vuosien määrä (ilman nollatäydennystä)	1, 12
`%M`	Kuukausien määrä (vähintään `2 numeroa)`	01, 11
`%m`	Kuukausien määrä (ilman nollatäydennystä)	1, 11
`%D`	Päivien määrä (vähintään `2 numeroa)`	01, 31
`%d`	Päivien määrä (ilman nollatäydennystä)	1, 31
`%H`	Tuntien määrä (vähintään `2 numeroa)`	01, 23
`%h`	Tuntien määrä (ilman nollatäydennystä)	1, 23
`%I`	Minuttien määrä (vähintään `2 numeroa)`	01, 59
`%i`	Minuttien määrä (ilman nollatäydennystä)	1, 59
`%S`	Sekuntien määrä (vähintään `2 numeroa)`	01, 59
`%s`	Sekuntien määrä (ilman nollatäydennystä)	1, 59
`%R`	Välin etumerkki (+ tai -)	+, -
`%r`	Välin etumerkki nimenomaisella ilmaisulla (- negatiivisella)	, -
`%%`	Prosenttimerkki	%

Esimerkki

Välin muotoilu päivinä ja tunteina:

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

Koodin suorituksen tulos:

'2 days, 5 hours'

Esimerkki

Välin muotoilu täydellisenä esityksenä:

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

Koodin suorituksen tulos:

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

Esimerkki

Välin muotoilu etunollilla:

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

Koodin suorituksen tulos:

'05:03'

Katso myös

luokka DateInterval,
joka edustaa aikaväliä
metodi DateTime::format,
joka muotoilee päivämäärän ja ajan
funktio date,
joka muotoilee aikaleiman