DateTimeImmutable::createFromInterface

(PHP 8)

DateTimeImmutable::createFromInterface — Returns new DateTimeImmutable object encapsulating the given DateTimeInterface object

说明

public static DateTimeImmutable::createFromInterface ( DateTimeInterface $object ) : DateTimeImmutable

参数

object: The DateTimeInterface object that needs to be converted to an immutable version. This object is not modified, but instead a new DateTimeImmutable object is created containing the same date, time, and timezone information.

返回值

Returns a new DateTimeImmutable instance.

范例

Example #1 Creating an immutable date time object


<?php
$date = new DateTime("2014-06-20 11:45 Europe/London");

$immutable = DateTimeImmutable::createFromInterface($date);

$date = new DateTimeImmutable("2014-06-20 11:45 Europe/London");
$also_immutable = DateTimeImmutable::createFromInterface($date);
?>

User Contributed Notes

divinity76 at gmail dot com 07-Jul-2021 11:12


php7 polyfill: 

<?php

function PolyfillDateTimeImmutableCreateFromInterface(DateTimeInterface $dti):DateTimeImmutable{

    $tz = $dti->getTimezone();

    $ret = DateTimeImmutable::createFromFormat(DateTimeInterface::RFC3339, $dti->format(DateTimeInterface::RFC3339));

    if(!!$tz){

        // without this: timezone +01:00

        // with this: timezone Europe/Oslo

        $ret = $ret->setTimezone($tz);

    }

    return $ret;

}



?>



testing it:

<?php

$dt = new DateTime("1970-01-01",timezone_open("Europe/Oslo"));

$dti = PolyfillDateTimeImmutableCreateFromInterface($dt);

var_dump($dti->format(DateTime::RFC3339), $dti->getTimezone());

die();

?>

gives:



string(25) "1970-01-01T00:00:00+01:00"

object(DateTimeZone)#2 (2) {

  ["timezone_type"]=>

  int(3)

  ["timezone"]=>

  string(11) "Europe/Oslo"

}



- and warning: using the TimeZone argument of the DateTimeImmutable constructor is a trap, in the example above if i used the constructor argument instead of setTimezone(), it would become "timezone_type=>1 timezone=>+01:00" instead of "timezone=>europe/oslo", the timezone name would be lost.