DateTimeImmutable createFromMutable() Function

0 0 1 minute read

The DateTimeImmutable::createFromMutable() function is an inbuilt function in PHP which is used to return the new DateTimeImmutable object encapsulating the given DateTime object.

Syntax:

DateTimeImmutable DateTimeImmutable::createFromMutable( DateTime $object )

Parameters: This function accepts a single parameter $object which is used to get the mutable DateTime object that you want to convert to an immutable version.

Return values: This function returns the DateTimeImmutable object on success or false on failure.

Example 1: Below programs illustrate the DateTimeImmutable::createFromMutable() function in PHP.

PHP

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

Output:

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

Example 2:

PHP

<?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)); 
  
?>

Output:

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"
}

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