PHP date_time_set() 函式

定義和用法

date_time_set() 函式是 DateTime::setTime() 函式的別名。使用它，您可以（重新）設定 DateTime 物件的時間。

語法

date_time_set($object, $hours, $minutes, $seconds, $microseconds)

引數

序號	引數及描述
1	object（必填）這是您需要設定日期的 DateTime 物件。
2	hours（必填）這是一個整數，表示要設定的時間的小時。
3	minute（必填）這是一個整數，表示要設定的時間的分鐘。
4	seconds（可選）這是一個整數，表示要設定的時間的秒數。
5	microseconds（可選）這是一個整數，表示要設定的時間的微秒數。

返回值

PHP date_time_set() 函式返回具有修改（時間）值的 DateTime 物件。如果失敗，此函式返回布林值 false。

PHP 版本

此函式首次引入於 PHP 5.2.0 版本，並在所有後續版本中有效。

示例

以下示例演示了 date_time_set 函式的用法：

線上演示

<?php
   //Creating a date
   $date = new DateTime();
   //Setting the date
   date_time_set($date, 7, 20, 35);   
   print("Date: ".date_format($date, "Y/m/d H:i:s"));
?>

這將產生以下結果：

Date: 2020/05/10 07:20:35

示例

以下示例建立一個 DateTime 物件，並使用 date_time_set() 函式修改其時間：

<?php
   //Date string
   $date_string = "25-09-1989 10:42:12";
   //Creating a DateTime object
   $date_time_Obj = date_create($date_string);
   print("Original Date: ".date_format($date_time_Obj, "Y/m/d H:i:s"));
   print("\n");
   //Setting the date
   $date = date_time_set($date_time_Obj, 6, 36, 3 );   
   print("Modified Date: ".date_format($date, "Y/m/d H:i:s"));
?>

這將產生以下結果：

Original Date: 1989/09/25 10:42:12
Modified Date: 1989/09/25 06:36:03

示例

呼叫此函式時，如果您傳遞的天數和月份值超過其範圍，它們將新增到其父值：

線上演示

<?php
   //Creating a date
   $date = new DateTime();
   //Setting the date
   date_time_set($date, 24, 15, 36);   
   print("Date: ".date_format($date, "Y/m/d H:i:s"));
?>

由於我們已將月份值設定為 15，因此三個月將新增到相應的時間：

Date: 2020/05/11 00:15:36

示例

$dateSrc = '2007-04-19 12:50 GMT';
$dateTime = date_create( $dateSrc);;
$retval = date_time_set( $dateTime, 20, 40, 10);
   
echo 'DateTime::format(): '.$dateTime->format('Y:M:D:H:i:s');
echo "\n";

# Using second function.
$dateTime = new DateTime($dateSrc);
$retval = $dateTime->setTime(20, 56,6);
   
echo 'DateTime::format(): '.$dateTime->format('Y:M:D:H:i:s');

這將產生以下結果：

DateTime::format(): 2007:Apr:Thu:20:40:10
DateTime::format(): 2007:Apr:Thu:20:56:06

php_function_reference.htm

列印頁面