PHP | DateTimeImmutable setDate()函数

在 PHP 中，DateTimeImmutable 类是一个不可变的 DateTime 类的变体。它通过提供不变的接口来支持日期和时间操作。

其中的 setDate() 函数可以设置一个新的日期，并返回一个新的对象，从而保持原对象的不变状态。它的语法如下：

public DateTimeImmutable setDate(int $year, int $month, int $day)

该函数接受三个参数，第一个参数为年份（必需），第二个参数为月份（必需），第三个参数为日期（必需）。它会返回一个新的 DateTimeImmutable 对象。

参数

setDate() 函数有以下参数：

• $year：表示要设置的年份，必须是一个整数值。
• $month：表示要设置的月份，必须是一个整数值，取值范围为 1~12。
• $day：表示要设置的日期，必须是一个整数值，取值范围为 1~31，具体取决于给定的月份和年份。

返回值

setDate() 函数返回一个新的 DateTimeImmutable 对象，其中仅包含传递的年份、月份和日期信息，而其他时间信息仍然基于原始对象。

示例

以下示例演示如何使用 setDate() 函数：

$date = new DateTimeImmutable('2022-12-15');
$newDate = $date->setDate(2023, 1, 10);

// 输出原始日期
echo $date->format('Y-m-d'); // 2022-12-15

// 输出新日期
echo $newDate->format('Y-m-d'); // 2023-01-10

在上面的例子中，我们创建了一个 DateTimeImmutable 对象，并使用 setDate() 函数将其日期设置为 2023 年 1 月 10 日。最终我们可以看到，原始日期仍然保持不变，而新日期被返回为一个新的对象。

总结

setDate() 函数是 PHP DateTimeImmutable 类中非常有用的一个函数，能够帮助我们设置一个新的日期，同时保持原始对象的不变性。我们可以充分利用这个函数来完成我们的日期操作。