查询

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

「 设置 DateTime 对象的日期部分 」


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

补充纠错
上一个函数: DateTime::modify()函数
下一个函数: DateTime::setISODate()函数
热门PHP函数
分享链接