設定 DateTime 對象的時間

DateTime::setTime

date_time_set

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

DateTime::setTime -- date_time_set設定 DateTime 對象的時間

說明

物件導向風格

public DateTime::setTime(
    int $hour,
    int $minute,
    int $second = 0,
    int $microsecond = 0
): DateTime

過程化風格

date_time_set(
    DateTime $object,
    int $hour,
    int $minute,
    int $second = 0,
    int $microsecond = 0
): DateTime

設定 DateTime 對象的時間。

參數

object

僅過程化風格:由 date_create() 返回的 DateTime 型別的對象。此函式會修改這個對象。

hour

小時。

minute

分鐘。

second

秒。

microsecond

微秒。

返回值

返回被修改的 DateTime 對象, 或者在失敗時返回 false.

更新日誌

版本 說明
7.1.0 新增 microsecond 參數。

範例

示例 #1 DateTime::setTime() 例程

物件導向風格

<?php
$date 
= new DateTime('2001-01-01');

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

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

過程化風格

<?php
$date 
date_create('2001-01-01');

date_time_set($date1455);
echo 
date_format($date'Y-m-d H:i:s') . "\n";

date_time_set($date145524);
echo 
date_format($date'Y-m-d H:i:s') . "\n";
?>

以上例程的輸出類似於:

2001-01-01 14:55:00
2001-01-01 14:55:24

示例 #2 超出有效範圍的部分會增加到上一級

<?php
$date 
= new DateTime('2001-01-01');

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

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

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

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

參見

發佈留言

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