DateTime::setTimestamp()函式—用法及示例

函式名：DateTime::setTimestamp()

函式介紹：DateTime::setTimestamp() 方法用於設定 DateTime 物件的 Unix 時間戳。

適用版本：該方法從 PHP 5.3.0 起可用，並且在所有版本的 PHP 中可用。

用法：

setTimestamp ( int $unixtimestamp ) : DateTime|false

引數：

• $unixtimestamp：要設定的 Unix 時間戳。它必須是一個整數。

返回值： 如果成功，該方法會返回一個 DateTime 物件，否則返回 false。

示例：

// 建立一個空的 DateTime 物件
$date = new DateTime();

// 設定時間戳為當前時間
$date->setTimestamp(time());
echo $date->format('Y-m-d H:i:s');  // 輸出當前時間

// 設定時間戳為指定時間
$date->setTimestamp(1612345678);
echo $date->format('Y-m-d H:i:s');  // 輸出指定時間

在上面的示例中，我們首先建立了一個空的 DateTime 物件 $date。然後，我們使用 setTimestamp() 方法將時間戳設定為當前時間，然後透過 format() 方法將其格式化為 'Y-m-d H:i:s' 的格式進行輸出。接著，我們使用 setTimestamp() 方法將時間戳設定為一個特定時間（1612345678），並再次透過 format() 方法進行輸出。

請注意，setTimestamp() 方法修改了 DateTime 物件本身，並返回修改後的 DateTime 物件。如果設定時間戳失敗（例如，超出有效範圍），則返回 false。