[函数]DateTimeImmutable::setTimezone()函数—用法及示例

函数名称：DateTimeImmutable::setTimezone()

函数描述：该函数用于设置DateTimeImmutable对象的时区。

适用版本：该函数在PHP版本5.5及以上版本可用。

语法：public DateTimeImmutable DateTimeImmutable::setTimezone ( DateTimeZone $timezone )

参数：

• $timezone: 必需，一个DateTimeZone对象，表示要设置的时区。

返回值：返回一个新的DateTimeImmutable对象，代表了被设置时区后的日期和时间。

示例：

// 创建一个原始的日期时间对象
$date = new DateTimeImmutable('2022-03-15 10:30:00', new DateTimeZone('America/New_York'));

// 设置时区为东京
$dateTokyo = $date->setTimezone(new DateTimeZone('Asia/Tokyo'));

// 输出原始日期时间对象
echo $date->format('Y-m-d H:i:s');  // 输出: 2022-03-15 10:30:00

// 输出新的日期时间对象（已设置成东京时区）
echo $dateTokyo->format('Y-m-d H:i:s');  // 输出: 2022-03-15 23:30:00

在上面的示例中，我们首先创建了一个DateTimeImmutable对象$date，代表了美国纽约的日期时间。然后使用setTimezone()函数将时区设置为东京，返回一个新的DateTimeImmutable对象$dateTokyo。最后，我们分别输出了原始的日期时间对象和新的日期时间对象，验证了时区设置的变化。

请注意，由于DateTimeImmutable对象是不可变的，因此setTimezone()函数不会修改原始对象，而是返回一个新的对象，该对象代表了设置新时区后的日期和时间。

此外，如果您要使用可变的DateTime对象并将时区设置为不同的值，请使用DateTime::setTimezone()函数。