DateTime::modify

date_modify

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

DateTime::modify -- date_modify — Ändert den Zeitstempel

Beschreibung

Objektorientierter Stil

public DateTime::modify(string $modifier): DateTime|false

Prozeduraler Stil

date_modify(DateTime $object, string $modifier): DateTime|false

Ändert den Zeitstempel eines DateTime-Objektes durch Erhöhen oder Verringern in einem von DateTimeImmutable::__construct() aktzeptierten Format.

Parameter-Liste

object: Nur bei prozeduralem Aufruf: Ein von date_create() zurückgegebenes DateTime-Objekt. Diese Funktion verändert dieses Objekt.
modifier: Ein Datums/Zeit Zeichenkette. Gültige Formate werden unter Datums- und Zeitformate erläutert.

Rückgabewerte

Gibt das geänderte DateTime-Objekt für die Methodenverkettung zurück. Bei einem Fehler wird false zurückgegeben.

Fehler/Exceptions

Nur bei objektorientierter API: Wenn eine ungültige Datum/Uhrzeit-Zeichenkette übergeben wird, wird eine DateMalformedStringException geworfen.

Changelog

Version	Beschreibung
8.3.0	Wirft nun eine DateMalformedStringException, statt eine Warnung auszugeben, wenn eine ungültige Zeichenkette an DateTime::modify() übergeben wird. Die Funktion date_modify() wurde nicht geändert.

Beispiele

Beispiel #1 DateTime::modify()-Beispiel

Objektorientierter Stil

<?php
$date = new DateTime('2006-12-12');
$date->modify('+1 day');
echo $date->format('Y-m-d');
?>

Prozeduraler Stil

<?php
$date = date_create('2006-12-12');
date_modify($date, '+1 day');
echo date_format($date, 'Y-m-d');
?>

Die obigen Bespiele erzeugen folgende Ausgabe:

2006-12-13

Beispiel #2 Vorsicht beim Addieren oder Subtrahieren von Monaten

<?php
$date = new DateTime('2000-12-31');

$date->modify('+1 month');
echo $date->format('Y-m-d') . "\n";

$date->modify('+1 month');
echo $date->format('Y-m-d') . "\n";
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

2001-01-31
2001-03-03

Beispiel #3 Alle Formate von Datum und Zeit werden unterstützt

<?php
$date = new DateTime('2020-12-31');

$date->modify('July 1st, 2023');
echo $date->format('Y-m-d H:i') . "\n";

$date->modify('Monday next week');
echo $date->format('Y-m-d H:i') . "\n";

$date->modify('17:30');
echo $date->format('Y-m-d H:i') . "\n";
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

2023-07-01 00:00
2023-07-03 00:00
2023-07-03 17:30

Siehe auch

strtotime() - Wandelt eine textuelle englische Datums- und Zeitbeschreibung in einen Unix-Zeitstempel um
DateTimeImmutable::modify() - Erzeugt ein neues Objekt mit geändertem Zeitstempel
DateTime::add() - Ändert ein DateTime-Objekt, wobei die Anzahl der Tage, Monate, Jahre, Stunden, Minuten und Sekunden hinzugefügt wird
DateTime::sub() - Subtrahiert eine Anzahl von Tagen, Monaten, Jahren, Stunden, Minuten und Sekunden von einem DateTime-Objekt.
DateTime::setDate() - Legt das Datum fest
DateTime::setISODate() - Legt das ISO-Datum fest
DateTime::setTime() - Legt die Uhrzeit fest
DateTime::setTimestamp() - Legt Datum und Zeit basierend auf einem Unix-Zeitstempel fest

Improve This Page

Learn how improve this page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

php_net at striderweb dot com ¶

1 day ago

You have to be a bit careful with variables here. If for example you want to add a variable amount of minutes you might use `->modify("+$min").  This will not work out if `$min` is a negative number, because modify will see the "+" and ignore the "-".  If `$min` equals -10, modify in this example will add ten minutes, not subtract!

What is happening is if the modify string has two operations, the first will be obeyed and later ones will be ignored.

So "+-10 minutes" will add ten minutes, even though you might expect it to add the negative number.  Similarly "--10 minutes" will subtract ten minutes, despite the apparent logic of subtracting a negative number.

＋add a note