【PHP8.x】createFromImmutableメソッドの使い方

createFromImmutableメソッドは、DateTimeImmutableオブジェクトから新しいDateTimeオブジェクトを作成するメソッドです。DateTimeImmutableオブジェクトは、一度作成されると変更できない不変（immutable）な日時オブジェクトであるのに対し、DateTimeオブジェクトは変更可能（mutable）な日時オブジェクトです。このメソッドを使用することで、不変なDateTimeImmutableオブジェクトが表す日時を、必要に応じて変更可能なDateTimeオブジェクトとして扱えるようになります。

具体的には、DateTimeImmutableオブジェクトを引数としてcreateFromImmutableメソッドに渡すと、そのDateTimeImmutableオブジェクトが持つ日時情報をコピーした新しいDateTimeオブジェクトが返されます。これにより、元のDateTimeImmutableオブジェクトには影響を与えずに、コピーされたDateTimeオブジェクトに対して日付や時刻の操作を行うことが可能になります。

システム開発においては、データベースから取得した日時データをDateTimeImmutableオブジェクトとして保持し、画面表示や計算処理などの特定の処理でのみDateTimeオブジェクトに変換して使用する、といったケースが考えられます。不変なオブジェクトを使用することで、意図しないデータの変更を防ぎ、プログラムの信頼性を高めることができます。そして、必要に応じてcreateFromImmutableメソッドを使用することで、柔軟な日時処理を実現できます。このメソッドは、PHPの日時処理において、不変性と可変性のバランスを取りながら、より安全で効率的なコードを書くための重要なツールと言えるでしょう。

Copy
1DateTime::createFromImmutable(DateTimeImmutable $object): DateTime

DateTimeImmutable $object

• DateTimeImmutable $object: 元となる DateTimeImmutable オブジェクト

DateTime

DateTimeImmutable オブジェクトから DateTime オブジェクトを生成して返します。