(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::setTimestamp — Sets the date and time based on a Unix timestamp
Like DateTime::setTimestamp() but works with DateTimeImmutable.
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
?>
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.