Función DateTimeImmutable createFromMutable()

La función DateTimeImmutable::createFromMutable() es una función incorporada en PHP que se usa para devolver el nuevo objeto DateTimeImmutable que encapsula el objeto DateTime dado.

Sintaxis:

DateTimeImmutable DateTimeImmutable::createFromMutable( DateTime $objeto )

Parámetros: esta función acepta un único parámetro $object que se utiliza para obtener el objeto DateTime mutable que desea convertir en una versión inmutable.

Valores devueltos: esta función devuelve el objeto DateTimeImmutable en caso de éxito o falso en caso de error.

Ejemplo 1: Los siguientes programas ilustran la función DateTimeImmutable::createFromMutable() en PHP.

<?php
  
$dateTime = new DateTime("2020-04-12");
  
var_dump(DateTimeImmutable::createFromMutable($dateTime));
  
?>

Producción:

object(DateTimeImmutable)#2 (3) {
  ["date"]=>
  string(26) "2020-04-12 00:00:00.000000"
  ["timezone_type"]=>
  int(3)
  ["timezone"]=>
  string(3) "UTC"
}

Ejemplo 2:

<?php
  
// Creating a new DateTime::add() object 
$datetime = new DateTime("2019-10-03T10:00:00");
  
var_dump(DateTimeImmutable::createFromMutable($datetime));
  
// Creating a new DateTimeImmutable() object 
$datetime = new DateTime(); 
    
// Initialising year, month and day 
$Year = '2019'; 
$Month = '10'; 
$Day = '03'; 
    
// Calling the DateTimeImmutable::setDate() function 
$datetime = $datetime->setDate($Year, $Month, $Day);
  
var_dump(DateTimeImmutable::createFromMutable($datetime));
  
?>

Producción:

object(DateTimeImmutable)#2 (3) {
  ["date"]=>
  string(26) "2019-10-03 10:00:00.000000"
  ["timezone_type"]=>
  int(3)
  ["timezone"]=>
  string(3) "UTC"
}
object(DateTimeImmutable)#1 (3) {
  ["date"]=>
  string(26) "2019-10-03 20:35:03.000000"
  ["timezone_type"]=>
  int(3)
  ["timezone"]=>
  string(3) "UTC"
}

Referencia: https://www.php.net/manual/en/datetimeimmutable.createfrommutable.php