Alters the timestamp

说明

面向对象风格

public DateTime DateTime::modify ( string $modify )

过程化风格

DateTime date_modify ( DateTime $object , string $modify )

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

参数

object: 仅过程化风格：由 date_create() 返回的 DateTime 类型的对象。此函数会修改这个对象。
modify: 日期/时间字符串。正确格式的说明详见日期与时间格式。

返回值

返回被修改的 DateTime 对象，或者在失败时返回 FALSE.

更新日志

版本	说明
5.3.6	Absolute date/time statements now take effect. Previously, only relative parts were used.
5.3.0	将返回值从`NULL`改为 DateTime 类型。

范例

Example #1 DateTime::modify() example

面向对象风格


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

过程化风格


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

以上例程会输出：

2006-12-13

Example #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";
?>

以上例程会输出：

2001-01-31
2001-03-03

参见

strtotime() - 将任何英文文本的日期时间描述解析为 Unix 时间戳
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