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。最后，我们分别输出原始对象和新对象的日期，可以看到原始对象的日期保持不变，而新对象的日期已被更新为指定的值。