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

    publicDateTime::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

    VersionBeschreibung
    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

    To Top