[函数]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，并不会更新日期。因此，在使用该方法设置日期前，需要确保传递有效的年份、月份和日期。