[edit] Last updated: Sat, 07 Jan 2012

DateTime::modify

date_modify

(PHP 5 >= 5.2.0)

DateTime::modify -- date_modify — Alters the timestamp

Beschreibung

Objektorientierter Stil

public DateTime DateTime::modify ( string $modify )

Prozeduraler Stil

DateTime date_modify ( DateTime $object , string $modify )

Alter the timestamp of a DateTime object by incrementing or decrementing in a format accepted by strtotime().

Parameter-Liste

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

Rückgabewerte

Gibt das DateTime-Objekt für die Verkettung von Methoden zurück Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version	Beschreibung
5.3.6	Absolute date/time statements now take effect. Previously, only relative parts were used.
5.3.0	Der Rückgabewert bei Erfolg wurde von `NULL` auf DateTime geändert.

Beispiele

Beispiel #1 DateTime::modify() example

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 Beware when adding or subtracting months


<?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

Siehe auch

strtotime() - Wandelt ein beliebiges in englischer Textform angegebenes Datum in einen UNIX-Zeitstempel (Timestamp) um
DateTime::add() - Adds an amount of days, months, years, hours, minutes and seconds to a DateTime object
DateTime::sub() - Subtracts an amount of days, months, years, hours, minutes and seconds from a DateTime object
DateTime::setDate() - Sets the date
DateTime::setISODate() - Sets the ISO date
DateTime::setTime() - Sets the time
DateTime::setTimestamp() - Sets the date and time based on an Unix timestamp

add a note User Contributed Notes DateTime::modify

tom at r dot je 18-Jun-2009 07:43


If you want to find the next working day (assuming mon-fri) you can use this:



<?php

$d = new DateTime();



$day = $d->format('w');



if ($day == 0 || $day >= 5) $d->modify('+' . ((7-$day+1) % 7) . ' days');

else $d->modify('+1 day');

?>

add a note