PHP | DateTimeImmutable setTime()函数

在 PHP 中，DateTimeImmutable 类提供了 setTime() 方法，用于设置时间。本文将对该函数进行详细介绍。

语法

public DateTimeImmutable DateTimeImmutable::setTime ( int $hour , int $minute [, int $second = 0 [, int $microseconds = 0 ]] )

描述

此方法返回一个新的 DateTimeImmutable 对象，该对象的时间被设置为指定的小时、分钟、秒和毫秒数。如果没有指定秒和微秒，则这些值将被默认为 0。

参数

• hour ：小时（0 ~ 23）
• minute ：分钟（0 ~ 59）
• second ：秒（0 ~ 59）- 可选，默认为 0。
• microseconds ：毫秒（0 ~ 1000000）- 可选，默认为 0。

返回值

返回一个新的 DateTimeImmutable 对象，该对象的时间被设置为指定的小时、分钟、秒和毫秒数。

示例

$date = new DateTimeImmutable('2022-02-22 00:00:00');
$dateNew = $date->setTime(10, 20, 30, 400000);

echo $date->format('Y-m-d H:i:s.u');          // 输出：2022-02-22 00:00:00.000000
echo $dateNew->format('Y-m-d H:i:s.u');       // 输出：2022-02-22 10:20:30.400000

注意事项

• setTime() 方法返回一个新的 DateTimeImmutable 对象，原日期对象不会被修改。
• 参数的取值范围需符合常规时间规则，如小时在 0 到 23 之间，分钟在 0 到 59 之间等。
• 参数 epoch (1970-01-01 00:00:00 UTC) 之前的值是无效的，参数超出范围的值会被递增一定量来归位于有效范围内。
• setTime() 方法不支持通过日期对象进行微调。如果需要微调日期对象，请考虑使用相关的 add() 方法。

综上所述，DateTimeImmutable 类中的 setTime() 方法可方便程序员根据需要设置日期时间。其使用灵活、功能强大，值得加以学习和掌握。