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

函式名稱：DateTime::setDate()

函式描述：用於設定 DateTime 物件的日期部分

適用版本：PHP 5, PHP 7

用法： DateTime::setDate(int $year, int $month, int $day): DateTime|false

引數：

• $year：要設定的年份，以四位數字表示。範圍為 0000 到 9999。
• $month：要設定的月份，範圍為 1 到 12。
• $day：要設定的日期，範圍為 1 到 31，根據給定的月份來決定有效的日期。

返回值：

• 如果成功設定日期，函式返回一個更新後的 DateTime 物件。
• 如果日期無效或超出範圍，函式返回 false。

示例：

$date = new DateTime();
echo $date->format('Y-m-d');  // 輸出當前日期

$date->setDate(2022, 10, 15);
echo $date->format('Y-m-d');  // 輸出設定後的日期

上述示例建立了一個 DateTime 物件，並使用 format() 方法列印了當前日期。然後，使用 setDate() 方法將日期設定為 2022 年 10 月 15 日，並再次使用 format() 方法列印了更新後的日期。輸出結果將會是：

2021-08-12
2022-10-15

需要注意的是，如果給定的日期無效（比如 2022 年 2 月 30 日），則 setDate() 方法將返回 false，並不會更新日期。因此，在使用該方法設定日期前，需要確保傳遞有效的年份、月份和日期。