DateTimeImmutable::setTime()函式—用法及示例

函式：DateTimeImmutable::setTime()

適用版本：PHP 5 >= 5.5.0, PHP 7, PHP 8

用法：DateTimeImmutable::setTime() 函式用於設定 DateTimeImmutable 物件的時間部分。

語法：public DateTimeImmutable DateTimeImmutable::setTime(int $hour, int $minute, int $second = 0, int $microseconds = 0) : DateTimeImmutable|false

引數：

• $hour（必需）：要設定的小時數（範圍：0-23）。
• $minute（必需）：要設定的分鐘數（範圍：0-59）。
• $second（可選）：要設定的秒數（範圍：0-59），預設為0。
• $microseconds（可選）：要設定的微秒數（範圍：0-999999），預設為0。

返回值：成功時返回一個新的 DateTimeImmutable 物件，失敗時返回 false。

示例：

$now = new DateTimeImmutable();

// 設定時間為15:30:45
$newDateTime = $now->setTime(15, 30, 45);

// 輸出新的日期時間
echo $newDateTime->format('Y-m-d H:i:s'); // 輸出：2022-01-01 15:30:45

在以上示例中，首先建立了一個當前時間的 DateTimeImmutable 物件 $now。然後使用 setTime() 方法設定了時間為 15:30:45，並將返回的新 DateTimeImmutable 物件賦值給 $newDateTime。最後，透過 format() 方法將新的日期時間格式化為字串，並進行輸出。