Php/docs/datetime.settime
DateTime::setTime
date_time_set
(PHP 5 >= 5.2.0, PHP 7)
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 参数。
|
范例
Example #1 DateTime::setTime() 例程
面向对象风格
<?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 超出有效范围的部分会增加到上一级
<?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