DateTime::add()函数—用法及示例

函数名称：DateTime::add()

函数描述：该函数在给定的日期时间上添加一个时间间隔。

适用版本：该函数可在PHP 5及以上版本中使用。

用法：

DateTime DateTime::add ( DateInterval $interval )

参数：

• $interval: 必需。一个DateInterval对象，表示要添加的时间间隔。

返回值：返回一个新的DateTime对象，表示添加时间间隔后的日期时间。

示例：

$datetime = new DateTime('2022-01-01 10:00:00');
echo $datetime->format('Y-m-d H:i:s');  // 输出: 2022-01-01 10:00:00
 
$interval = new DateInterval('P1D');  // 添加1天的时间间隔
$datetime->add($interval);
echo $datetime->format('Y-m-d H:i:s');  // 输出: 2022-01-02 10:00:00
 
$interval = new DateInterval('P2W');  // 添加2周的时间间隔
$datetime->add($interval);
echo $datetime->format('Y-m-d H:i:s');  // 输出: 2022-01-16 10:00:00
 
$interval = new DateInterval('PT3H');  // 添加3小时的时间间隔
$datetime->add($interval);
echo $datetime->format('Y-m-d H:i:s');  // 输出: 2022-01-16 13:00:00

注意事项：

• 要添加的时间间隔由一个DateInterval对象表示，可以使用各种格式的时间间隔，如年、月、日、小时、分钟、秒等。
• 该函数会修改原始的DateTime对象，同时返回一个新的DateTime对象，所以在使用后如果需要保留原始的日期时间，请使用新的DateTime对象接收返回值。