Sets the time

DateTimeImmutable::setTime

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

DateTimeImmutable::setTimeSets the time

說明

public DateTimeImmutable::setTime(
    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(1455);
echo 
$date->format('Y-m-d H:i:s') . "\n";

$newDate $date->setTime(145524);
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(145524);
echo 
$newDate->format('Y-m-d H:i:s') . "\n";

$newDate $date->setTime(145565);
echo 
$newDate->format('Y-m-d H:i:s') . "\n";

$newDate $date->setTime(146524);
echo 
$newDate->format('Y-m-d H:i:s') . "\n";

$newDate $date->setTime(255524);
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

參見

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *