DateTime::modify
date_modify
(PHP 5 >= 5.2.0, PHP 7)
DateTime::modify -- date_modify — 修改日期时间对象的值
参数
-
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
参见
- strtotime() - 将任何字符串的日期时间描述解析为 Unix 时间戳
- DateTime::add() - 给一个 DateTime 对象增加一定量的天，月，年，小时，分钟 以及秒。
- DateTime::sub() - 对一个 DateTime 对象减去一定量的 日、月、年、小时、分钟和秒。
- DateTime::setDate() - 设置 DateTime 对象的日期
- DateTime::setISODate() - 设置 ISO 日期
- DateTime::setTime() - 设置 DateTime 对象的时间
- DateTime::setTimestamp() - 以 Unix 时间戳的方式设置 DateTime 对象
