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

PHP函式：DateTimeImmutable::setDate()

適用版本：PHP 5 >= 5.5.0, PHP 7

用法：DateTimeImmutable::setDate() 方法用於設定 DateTimeImmutable 物件的日期部分。它接受三個引數：年份、月份和日期，返回一個新的 DateTimeImmutable 物件。原始的 DateTimeImmutable 物件保持不變。

語法：public DateTimeImmutable DateTimeImmutable::setDate(int $year, int $month, int $day)

引數：

• $year：要設定的年份，範圍在 1 到 9999 之間。
• $month：要設定的月份，範圍在 1 到 12 之間。
• $day：要設定的日期，範圍可以是 1 到 31 之間，也可以根據月份的不同而不同。

返回值：返回一個新的 DateTimeImmutable 物件，該物件的日期部分已被設定為指定的值。

示例：

$date = new DateTimeImmutable('2022-01-01');
$newDate = $date->setDate(2023, 02, 15);

echo $date->format('Y-m-d');    // 輸出：2022-01-01
echo $newDate->format('Y-m-d'); // 輸出：2023-02-15

在上面的示例中，我們建立了一個 DateTimeImmutable 物件 $date 並將其日期設定為 2022-01-01。然後，使用 setDate() 方法將日期部分設定為 2023 年 2 月 15 日，並返回一個新的 DateTimeImmutable 物件 $newDate。最後，我們分別輸出原始物件和新物件的日期，可以看到原始物件的日期保持不變，而新物件的日期已被更新為指定的值。