在线文档教程
PHP
日期和时间 | Date and Time

DateTime::setTime

DateTime::setTime

date_time_set

(PHP 5 >= 5.2.0, PHP 7)

DateTime :: setTime - date_time_set - 设置时间

描述

面向对象的风格

public DateTime DateTime::setTime ( int $hour , int $minute [, int $second = 0 [, int $microseconds = 0 ]] )

程序风格

DateTime date_time_set ( DateTime $object , int $hour , int $minute [, int $second = 0 [, int $microseconds = 0 ]] )

将DateTime对象的当前时间重置为不同的时间。

参数

object

仅限过程样式:由date_create()返回的DateTime对象。该函数修改这个对象。

hour

一小时的时间。

minute

一分钟的时间。

second

第二次。

microseconds

时间的微秒。

返回值

返回方法链接或FALSE失败时的DateTime对象。

更新日志

描述
7.1.0微秒参数被添加。
5.3.0将成功的返回值从NULL更改为DateTime。

例子

示例 #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

示例#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