DateInterval::format
Formatiert ein Intervall
&reftitle.description;
public stringDateInterval::format
stringformat
Formatiert ein Intervall.
&reftitle.parameters;
format
Die folgenden Zeichen werden in der Zeichenkette des Parameters
<parameter>format</parameter> erkannt. Jedem Formatzeichen muss ein
Prozentzeichen (<literal>%</literal>) vorangestellt werden.
format-Zeichen
&Description;
Beispielwerte
%
%-Zeichen
%
Y
Jahre, numerisch, mindestens 2 Ziffern mit vorangestellter 0
01, 03
y
Jahre, numerisch
1, 3
M
Monate, numerisch, mindestens 2 Ziffern mit vorangestellter 0
01, 03, 12
m
Monate, numerisch
1, 3, 12
D
Tage, numerisch, mindestens 2 Ziffern mit vorangestellter 0
01, 03, 31
d
Tage, numerisch
1, 3, 31
a
Gesamtzahl der Tage als Ergebnis von
DateTime::diff, andernfalls
(unknown)
4, 18, 8123
H
Stunden, numerisch, mindestens 2 Ziffern mit vorangestellter 0
01, 03, 23
h
Stunden, numerisch
1, 3, 23
I
Minuten, numerisch, mindestens 2 Ziffern mit vorangestellter 0
01, 03, 59
i
Minuten, numerisch
1, 3, 59
S
Sekunden, numerisch, mindestens 2 Ziffern mit vorangestellter 0
01, 03, 57
s
Sekunden, numerisch
1, 3, 57
F
Mikrosekunden, numerisch, mindestens 6 Ziffern mit vorangestellter 0
007701, 052738, 428291
f
Mikrosekunden, numerisch
7701, 52738, 428291
R
Vorzeichen "-" wenn negativ,
"+" wenn positiv
-, +
r
Vorzeichen "-" wenn negativ, leer wenn positiv
-,
&reftitle.returnvalues;
Gibt ein formatiertes Intervall zurück.
&reftitle.changelog;
&Version;
&Description;
7.2.12
Die Formate F und f sind nun
immer positiv.
7.1.0
Die Formatzeichen F und f wurden
hinzugefügt.
&reftitle.examples;
<classname>DateInterval</classname>-Beispiel
format('%d Tage');
]]>
&example.outputs;
<classname>DateInterval</classname> und Überträge
format('%d Tage');
]]>
&example.outputs;
<classname>DateInterval</classname> und
<methodname>DateTime::diff</methodname> mit den Modifikatoren %a und %d
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)');
]]>
&example.outputs;
&reftitle.notes;
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.
&reftitle.seealso;
DateTime::diff