DateTimeImmutable::setTime
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::setTime — Sets the time
說明
public DateTimeImmutable::setTime(
int
int
int
int
): DateTimeImmutable
int
$hour,int
$minute,int
$second = 0,int
$microsecond = 0): DateTimeImmutable
Returns a new DateTimeImmutable object with the time set to the given time.
參數
-
object -
僅過程化風格：由 date_create() 返回的 DateTime 型別的對象。此函式會修改這個對象。
-
hour -
Hour of the time.
-
minute -
Minute of the time.
-
second -
Second of the time.
-
microsecond -
Microsecond of the time.
返回值
返回新修改的 DateTimeImmutable 對像 或者在失敗時返回 false.
更新日誌
| 版本 | 說明 |
|---|---|
| 7.1.0 | The microsecond parameter was added. |
範例
示例 #1 DateTimeImmutable::setTime() example
物件導向風格
<?php
$date = new DateTimeImmutable('2001-01-01');
$newDate = $date->setTime(14, 55);
echo $date->format('Y-m-d H:i:s') . "\n";
$newDate = $date->setTime(14, 55, 24);
echo $date->format('Y-m-d H:i:s') . "\n";
?>
以上例程的輸出類似於：
2001-01-01 14:55:00 2001-01-01 14:55:24
示例 #2 Values exceeding ranges are added to their parent values
<?php
$date = new DateTimeImmutable('2001-01-01');
$newDate = $date->setTime(14, 55, 24);
echo $newDate->format('Y-m-d H:i:s') . "\n";
$newDate = $date->setTime(14, 55, 65);
echo $newDate->format('Y-m-d H:i:s') . "\n";
$newDate = $date->setTime(14, 65, 24);
echo $newDate->format('Y-m-d H:i:s') . "\n";
$newDate = $date->setTime(25, 55, 24);
echo $newDate->format('Y-m-d H:i:s') . "\n";
?>
以上例程會輸出：
2001-01-01 14:55:24 2001-01-01 14:56:05 2001-01-01 15:05:24 2001-01-02 01:55:24
參見
- DateTimeImmutable::setDate() - Sets the date
- DateTimeImmutable::setISODate() - Sets the ISO date