PHP Conference Nagoya 2025

DateTime::sub

date_sub

(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.

Beschreibung

Objektorientierter Stil

public DateTime::sub(DateInterval $interval): DateTime

Prozeduraler Stil

date_sub(DateTime $object, DateInterval $interval): DateTime

Ä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.

Parameter-Liste

object

Nur bei prozeduralem Aufruf: Ein von date_create() zurückgegebenes DateTime-Objekt. Diese Funktion verändert dieses Objekt.

interval

Ein DateInterval-Objekt

Rückgabewerte

Gibt das geänderte DateTime-Objekt für die Methodenverkettung zurück.

Fehler/Exceptions

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.

Changelog

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.

Siehe auch

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top