(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTime::sub -- date_sub — 從 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() 則沒有變更。 |