函数名:DateTimeImmutable::add()
适用版本:所有 PHP 版本(PHP 5 >= 5.5.0, PHP 7)
用法:DateTimeImmutable::add() 函数用于创建并返回一个新的 DateTimeImmutable 对象,通过给定的时间间隔将当前日期时间增加。它不会修改原始的 DateTimeImmutable 对象,而是返回一个新的对象。
语法:public DateTimeImmutable DateTimeImmutable::add(DateInterval $interval)
参数:
- $interval(必填):一个 DateInterval 对象,表示要添加的时间间隔。
返回值:
- 返回一个新的 DateTimeImmutable 对象,表示添加了指定时间间隔后的日期时间。
示例:
$date = new DateTimeImmutable('2022-01-01');
$interval = new DateInterval('P2D');
$newDate = $date->add($interval);
echo $newDate->format('Y-m-d'); // 输出:2022-01-03
在上面的示例中,我们创建了一个 DateTimeImmutable 对象 $date
,表示日期为 2022-01-01。然后,我们创建了一个 DateInterval 对象 $interval
,表示要添加的时间间隔为 2 天。接下来,我们使用 add()
函数将时间间隔 $interval
添加到 $date
中,返回一个新的 DateTimeImmutable 对象 $newDate
。最后,我们通过调用 $newDate->format('Y-m-d')
来格式化输出新的日期,结果为 2022-01-03。注意,原始的 $date
对象并没有被修改。