PHP Conference Japan 2024

DateTime::sub

date_sub

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

DateTime::sub -- date_sub 從 DateTime 物件減去指定的天數、月數、年數、小時數、分鐘數和秒數

說明

物件導向風格

公開 DateTime::sub(DateInterval $interval): DateTime

程序式風格

date_sub(DateTime $object, DateInterval $interval): DateTime

透過減去指定的 DateInterval 物件來修改指定的 DateTime 物件。

類似 DateTimeImmutable::sub(),但作用於 DateTime

程序式版本將 DateTime 物件作為其第一個參數。

參數

object

僅限程序式風格:由 date_create() 返回的 DateTime 物件。此函式會修改此物件。

interval

一個 DateInterval 物件

返回值

返回修改後的 DateTime 物件,以便進行方法鏈式調用。

錯誤/異常

僅限物件導向 API:如果嘗試進行不支援的操作,例如使用代表相對時間規格(如 next weekday)的 DateInterval 物件,則會拋出 DateInvalidOperationException 異常。

更新日誌

版本 說明
8.3.0 現在,當嘗試進行不支援的操作時,DateTime::sub() 會拋出 DateInvalidOperationException 異常,而不是發出警告。 date_sub() 則沒有變更。

參見

新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。
To Top