date_time_set()

1. 定义

该函数为DateTime对象setTime()方法的别名,用以设置DateTime对象的时间。 返回被设置时间后的DateTime对象,失败则返回FALSE。

2. 语法

public 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

3. 参数说明

参数 可选性 数据类型 描述
$object 必需 DateTime 日期时间对象
$hour 必需 整型 被设置的小时
$minute 必需 整型 被设置的分钟
$second 可选 整型 被设置的秒
$microseconds 可选 整型 被设置的微秒

4. 示例

<?php

// date_time_set()
// 设置`DateTime`对象的时间

// 面向对象式
$date = new DateTime('2019-07-15');
echo '指定时间为:', $date->format('Y-m-d H:i:s'),"\n";// 输出:指定时间为:2019-07-15 00:00:00
$date->setTime(18, 30, 0, 0);
echo '修改后的时间为:', $date->format('Y-m-d H:i:s'),"\n";// 输出:修改后的时间为:2019-07-15 18:30:00

// 面向过程式
$date = date_create('2019-07-15');
echo '指定时间为:', date_format($date, 'Y-m-d H:i:s'),"\n";// 输出:指定时间为:2019-07-15 00:00:00
date_time_set($date, 18, 30, 0, 0);
echo '修改后的时间为:', date_format($date, 'Y-m-d H:i:s'),"\n";// 输出:修改后的时间为:2019-07-15 18:30:00

5. 延展阅读

  • date_date_set():设置DateTime对象的日期
  • date_isodate_set():以ISO 8601规范的格式(以周和日作为日期参考, 而不是月和日)设置日期