(PHP 5 >= 5.2.0, PHP 7)
DateTime::setTime -- date_time_set — Sets the time
面向对象风格
$hour
, int $minute
[, int $second
= 0
[, int $microseconds
= 0
]] )过程化风格
$object
, int $hour
, int $minute
[, int $second
= 0
[, int $microseconds
= 0
]] )Resets the current time of the DateTime object to a different time.
object
仅过程化风格:由 date_create() 返回的 DateTime 类型的对象。此函数会修改这个对象。
hour
Hour of the time.
minute
Minute of the time.
second
Second of the time.
microseconds
Microsecond of the time.
返回被修改的 DateTime 对象, 或者在失败时返回 FALSE
.
版本 | 说明 |
---|---|
7.1.0 | The microseconds parameter was added. |
5.3.0 | 将返回值从NULL 改为 DateTime 类型。 |
Example #1 DateTime::setTime() example
面向对象风格
<?php
$date = new DateTime('2001-01-01');
$date->setTime(14, 55);
echo $date->format('Y-m-d H:i:s') . "\n";
$date->setTime(14, 55, 24);
echo $date->format('Y-m-d H:i:s') . "\n";
?>
过程化风格
<?php
$date = date_create('2001-01-01');
date_time_set($date, 14, 55);
echo date_format($date, 'Y-m-d H:i:s') . "\n";
date_time_set($date, 14, 55, 24);
echo date_format($date, 'Y-m-d H:i:s') . "\n";
?>
以上例程的输出类似于:
2001-01-01 14:55:00 2001-01-01 14:55:24
Example #2 Values exceeding ranges are added to their parent values
<?php
$date = new DateTime('2001-01-01');
$date->setTime(14, 55, 24);
echo $date->format('Y-m-d H:i:s') . "\n";
$date->setTime(14, 55, 65);
echo $date->format('Y-m-d H:i:s') . "\n";
$date->setTime(14, 65, 24);
echo $date->format('Y-m-d H:i:s') . "\n";
$date->setTime(25, 55, 24);
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