Die format-Methode der DateInterval-Klasse

Die Methode format der Klasse DateInterval wandelt ein Zeitintervall in eine String-Darstellung gemäß dem angegebenen Format um. Sie akzeptiert als Parameter einen Format-String, der spezielle Symbole enthält, und gibt einen formatierten String zurück.

Syntax

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

Spezielle Symbole

Spezifizierer	Beschreibung	Beispiel
`%Y`	Anzahl der Jahre (mindestens `2 Stellen)`	01, 12
`%y`	Anzahl der Jahre (ohnt Auffüllung mit Nullen)	1, 12
`%M`	Anzahl der Monate (mindestens `2 Stellen)`	01, 11
`%m`	Anzahl der Monate (ohne Auffüllung mit Nullen)	1, 11
`%D`	Anzahl der Tage (mindestens `2 Stellen)`	01, 31
`%d`	Anzahl der Tage (ohne Auffüllung mit Nullen)	1, 31
`%H`	Anzahl der Stunden (mindestens `2 Stellen)`	01, 23
`%h`	Anzahl der Stunden (ohne Auffüllung mit Nullen)	1, 23
`%I`	Anzahl der Minuten (mindestens `2 Stellen)`	01, 59
`%i`	Anzahl der Minuten (ohne Auffüllung mit Nullen)	1, 59
`%S`	Anzahl der Sekunden (mindestens `2 Stellen)`	01, 59
`%s`	Anzahl der Sekunden (ohne Auffüllung mit Nullen)	1, 59
`%R`	Vorzeichen des Intervalls (+ oder -)	+, -
`%r`	Vorzeichen des Intervalls mit expliziter Angabe (- bei negativem)	, -
`%%`	Prozentzeichen	%

Beispiel

Formatierung eines Intervalls in Tagen und Stunden:

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

Ergebnis der Codeausführung:

'2 days, 5 hours'

Beispiel

Formatierung eines Intervalls in vollständiger Darstellung:

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

Ergebnis der Codeausführung:

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

Beispiel

Formatierung eines Intervalls mit führenden Nullen:

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

Ergebnis der Codeausführung:

'05:03'

Siehe auch

die Klasse DateInterval,
die ein Zeitintervall repräsentiert
die Methode DateTime::format,
die Datum und Uhrzeit formatiert
die Funktion date,
die einen Zeitstempel formatiert