(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTime::sub -- date_sub — Subtrahiert eine Anzahl von Tagen, Monaten, Jahren, Stunden, Minuten und Sekunden von einem DateTime-Objekt.
Objektorientierter Stil
Prozeduraler Stil
Ändert das gegebene DateTime-Objekt indem das angegebene DateInterval-Objekt abgezogen wird.
Wie DateTimeImmutable::sub(), verwendet aber DateTime.
Die prozedurale Version verwendet das DateTime-Objekt als ersten Parameter.
object
Nur bei prozeduralem Aufruf: Ein von date_create() zurückgegebenes DateTime-Objekt. Diese Funktion verändert dieses Objekt.
interval
Ein DateInterval-Objekt
Gibt das geänderte DateTime-Objekt für die Methodenverkettung zurück.
Nur bei objektorientierter API: Wenn versucht wird, eine nicht unterstützte
Operation durchzuführen, z. B. mit einem
DateInterval-Objekt, das relative Zeitangaben wie
next weekday
enthält, wird eine
DateInvalidOperationException geworfen.
Version | Beschreibung |
---|---|
8.3.0 | Wirft nun eine DateInvalidOperationException, statt eine Warnung auszugeben, wenn versucht wird, mit DateTime::sub() eine nicht unterstützte Operation durchzuführen. Die Funktion date_sub() wurde nicht geändert. |