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物件接收返回值。