DateTimeImmutable::setTimestamp

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

DateTimeImmutable::setTimestamp — Sets the date and time based on a Unix timestamp

说明

public DateTimeImmutable::setTimestamp ( int $timestamp ) : DateTimeImmutable

Like DateTime::setTimestamp() but works with DateTimeImmutable.

User Contributed Notes

Philip 15-Jul-2021 11:03


This function will not change the value of the DateTimeImmutable object as the method name might suggest. The object, after all, immutable.



<?php

   $dti = new DateTimeImmutable();

   echo $dti->getTimestamp(); // e.g. 123456789

   $dti->setTimestamp(987654321);

   echo $dti->getTimestamp(); // 123456789



   $x = $dti->setTimestamp (987654321);

   echo $x->getTimestamp(); // 987654321

?>

ben at hl9 dot net 28-Dec-2018 07:21


Note that this is not the right way to initiate a \DateTimeImmutable object with a numeric Unix timestamp.  



<?php

// Wrong, despite the documention *kind of* alluding to it 

$obj = \DateTimeImmutable::setTimestamp(time() - 1);



// Also won't work

$obj = new \DateTimeImmutable(time() - 1)



// Correct, works, clean single line

$obj = (new \DateTimeImmutable())->setTimestamp(time() - 1);

?>



... In fact, this is a non-static method and thus should not be called statically.