array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'datetime.sub.php', 1 => 'DateTime::sub', 2 => 'Subtrahiert eine Anzahl von Tagen, Monaten, Jahren, Stunden, Minuten und Sekunden von einem DateTime-Objekt.', ), 'up' => array ( 0 => 'class.datetime.php', 1 => 'DateTime', ), 'prev' => array ( 0 => 'datetime.settimezone.php', 1 => 'DateTime::setTimezone', ), 'next' => array ( 0 => 'class.datetimeimmutable.php', 1 => 'DateTimeImmutable', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/datetime/datetime/sub.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 ausgelöst.

Changelog

Version Beschreibung
8.3.0 Löst nun eine DateInvalidOperationException aus, 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