函数: DateTimeImmutable::modify()
适用版本: PHP 5 >= 5.5.0, PHP 7
用法: DateTimeImmutable::modify(string $modify) : DateTimeImmutable|false
说明: 修改 DateTimeImmutable 对象的时间。返回一个新的 DateTimeImmutable 对象,原始对象不受影响。
参数:
- modify: 要应用于日期时间的修改字符串,可以是任何有效的日期时间格式。
返回值:
- 成功时,返回一个新的 DateTimeImmutable 对象,表示修改后的日期时间。
- 失败时,返回 false。
示例:
// 创建一个不可变的当前日期时间对象 $datetime = new DateTimeImmutable();
// 输出原始日期时间 echo '原始日期时间: ' . $datetime->format('Y-m-d H:i:s') . "\n";
// 修改日期时间为两天后的时间 $modifiedDatetime = $datetime->modify('+2 days');
// 输出修改后的日期时间 echo '修改后的日期时间: ' . $modifiedDatetime->format('Y-m-d H:i:s') . "\n";
// 使用不同的修改字符串修改时间 $modifiedDatetime2 = $datetime->modify('-3 hours');
// 输出修改后的日期时间 echo '修改后的日期时间(2): ' . $modifiedDatetime2->format('Y-m-d H:i:s') . "\n";
输出: 原始日期时间: 2022-01-01 12:00:00 修改后的日期时间: 2022-01-03 12:00:00 修改后的日期时间(2): 2022-01-01 09:00:00