DateTime::modify

date_modify

(PHP 5 >= 5.2.0, PHP 7)

DateTime::modify -- date_modify — 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

参见