DateTimeImmutable::add()函式—用法及示例

函式名：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 物件並沒有被修改。