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