大网数据广告活动
PHP 语言与运行手册

DateTimeImmutable::modify · Creates a new object with modified timestamp

· 52CE 我爱测

DateTimeImmutable::modify — Creates a new object with modified timestamp

DateTimeImmutable::modify

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

DateTimeImmutable::modify — Creates a new object with modified timestamp

说明

#[\NoDiscard(message: "as DateTimeImmutable::modify() does not modify the object itself")]
public function DateTimeImmutable::modify(string $modifier): DateTimeImmutable

Creates a new DateTimeImmutable object with modified timestamp. The original object is not modified.

参数

modifier

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

返回值

Returns DateTimeImmutable on success. 过程化风格在失败时返回 false。

错误/异常

If an invalid Date/Time string is passed, DateMalformedStringException is thrown. Previous to PHP 8.3, this was a warning.

更新日志

版本 说明
8.4.0 Now has a tentative return type of DateTimeImmutable. Previously it was DateTimeImmutable|false.
8.3.0 DateTimeImmutable::modify() now throws DateMalformedStringException if an invalid string is passed. Previously, it returned false, and a warning was emitted.

示例

示例 #1 DateTimeImmutable::modify() example

面向对象风格

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

以上示例会输出:

2006-12-13

示例 #2 Beware when adding or subtracting months

<?php
$date = new DateTimeImmutable('2000-12-31');

$newDate1 = $date->modify('+1 month');
echo $newDate1->format('Y-m-d') . "\n";

$newDate2 = $newDate1->modify('+1 month');
echo $newDate2->format('Y-m-d') . "\n";

以上示例会输出:

2001-01-31
2001-03-03

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。