DateInterval::format
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateInterval::format — Formatiert ein Intervall
Beschreibung
$format): stringFormatiert ein Intervall.
Parameter-Liste
-
format -
Die folgenden Zeichen werden in der Zeichenkette des Parameters formaterkannt. Jedem Formatzeichen muss ein Prozentzeichen (%) vorangestellt werden.format-ZeichenBeschreibung Beispielwerte %%-Zeichen%YJahre, numerisch, mindestens 2 Ziffern mit vorangestellter 0 01,03yJahre, numerisch 1,3MMonate, numerisch, mindestens 2 Ziffern mit vorangestellter 0 01,03,12mMonate, numerisch 1,3,12DTage, numerisch, mindestens 2 Ziffern mit vorangestellter 0 01,03,31dTage, numerisch 1,3,31aGesamtzahl der Tage als Ergebnis von DateTime::diff(), andernfalls (unknown)4,18,8123HStunden, numerisch, mindestens 2 Ziffern mit vorangestellter 0 01,03,23hStunden, numerisch 1,3,23IMinuten, numerisch, mindestens 2 Ziffern mit vorangestellter 0 01,03,59iMinuten, numerisch 1,3,59SSekunden, numerisch, mindestens 2 Ziffern mit vorangestellter 0 01,03,57sSekunden, numerisch 1,3,57FMikrosekunden, numerisch, mindestens 6 Ziffern mit vorangestellter 0 007701,052738,428291fMikrosekunden, numerisch 7701,52738,428291RVorzeichen " -" wenn negativ, "+" wenn positiv-,+rVorzeichen " -" wenn negativ, leer wenn positiv-,
Rückgabewerte
Gibt ein formatiertes Intervall zurück.
Changelog
| Version | Beschreibung |
|---|---|
| 7.1.0 |
Die Formatzeichen F und f wurden
hinzugefügt.
|
Beispiele
Beispiel #1 DateInterval-Beispiel
<?php
$interval = new DateInterval('P2Y4DT6H8M');
echo $interval->format('%d Tage');
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
4 Tage
Beispiel #2 DateInterval und Überträge
<?php
$interval = new DateInterval('P32D');
echo $interval->format('%d Tage');
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
32 Tage
Beispiel #3 DateInterval und DateTime::diff() mit den Modifikatoren %a und %d
<?php
$january = new DateTime('2010-01-01');
$february = new DateTime('2010-02-01');
$interval = $february->diff($january);
// %a gibt die Gesamtzahl der Tage aus.
echo $interval->format('%a Tage insgesamt')."\n";
// Während %d nur die Anzahl der Tage ausgibt, die noch nicht durch den
// Monat abgedeckt sind.
echo $interval->format('%m Monat, %d Tage)');
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
31 Tage insgesamt 1 Monat, 0 Tage
Anmerkungen
Hinweis:
Die Methode DateInterval::format() berechnet die Zeiteinheiten nicht neu und überträgt sie nicht, wenn die Datumswerte überlaufen. Dies ist beabsichtigt, weil es nicht möglich ist, Werte wie
"32 days"zu übertragen, die als alles von"1 month and 4 days"bis"1 month and 1 day"interpretiert werden könnten.
