DateTime::modify

date_modify

(PHP 5 >= 5.2.0, PHP 7)

DateTime::modify -- date_modify修改日期时间对象的值

说明

面向对象风格

public DateTime::modify ( string $modify ) : DateTime

过程化风格

date_modify ( DateTime $object , string $modify ) : DateTime

修改一个日期时间对象的值。 支持 strtotime() 函数所允许的字符串。

参数

object

仅过程化风格:由 date_create() 返回的 DateTime 类型的对象。此函数会修改这个对象。

modify

日期/时间字符串。正确格式的说明详见 日期与时间格式

返回值

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

更新日志

版本 说明
5.3.6 支持绝对的日期时间作为变化量, 在之前的版本中,仅支持相对变化量。
5.3.0将返回值从NULL改为 DateTime 类型。

范例

Example #1 DateTime::modify() 例程

面向对象风格

<?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 增加或者减少月份的时候需要注意

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

参见