PHP date_date_set() 函式

定義和用法

date_date_set() 函式是 DateTime::setDate() 的別名。使用它，您可以（重新）設定 DateTime 物件的日期。

語法

date_date_set($object, $year, $month, $day)

引數

序號	引數和描述
1	object（必填）這是您需要設定日期的 DateTime 物件。
2	year（必填）這是一個整數，表示日期的年份。
3	month（必填）這是一個整數，表示日期的月份。
4	day（必填）這是一個整數，表示日期的天數。

返回值

PHP date_date_set() 函式返回修改後的 DateTime 物件。如果失敗，則返回布林值 false。

PHP 版本

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

示例

以下示例演示了 date_date_set 函式的用法 -

線上演示

<?php
   //Creating a date
   $date = new DateTime();
   //Setting the date
   date_date_set($date, 2019, 07, 17);   
   print("Date: ".date_format($date, "Y/m/d"));
?>

這將產生以下結果 -

Date: 2019/07/17

示例

以下示例建立一個 DateTime 物件，並使用 date_date_set() 函式修改其日期 -

<?php
   //Date string
   $date_string = "25-09-1989";
   //Creating a DateTime object
   $date_time_Obj = date_create($date_string);
   print("Original Date: ".date_format($date_time_Obj, "Y/m/d"));
   print("\n");
   //Setting the date
   $date = date_date_set($date_time_Obj, 2015, 11, 25 );   
   print("Modified Date: ".date_format($date, "Y/m/d"));
?>

這將產生以下結果 -

Original Date: 1989/09/25
Modified Date: 2015/11/25

示例

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

線上演示

<?php
   //Creating a date
   $date = new DateTime();
   //Setting the date
   date_date_set($date, 2019, 15, 17);   
   print("Date: ".date_format($date, "Y/m/d"));
?>

由於我們將月份值設定為 15。三個月將新增到相應的日期 -

Date: 2020/03/17

示例

$dateSrc = '2005-04-19 12:50 GMT';
$dateTime = date_create( $dateSrc);;
# Now set a new date using date_date_set();
date_date_set( $dateTime, 2000, 12, 12);
   
echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");
echo "
";

# Using second function.
$dateTime = new DateTime($dateSrc);
$dateTime->setDate( 1999, 10, 12);
   
echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");

這將產生以下結果 -

New Formatted date is 2000-12-12T12:50:00Z
New Formatted date is 1999-10-12T12:50:00Z

php_function_reference.htm

列印頁面