(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のみ、
サポートされていない操作を試みた場合に
DateInvalidOperationException がスローされます。
サポートされていない操作の例としては、
next weekday のような相対時刻を表現する
DateInterval を使った場合が挙げられます。
| バージョン | 説明 |
|---|---|
| 8.3.0 | サポートされていない操作を試みた場合に、警告を発生させるのではなく、 DateInvalidOperationException がスローされるようになりました。 date_sub() は変更されていません。 |