DateTimeImmutable::setTimestamp

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

DateTimeImmutable::setTimestampLegt das Datum und die Uhrzeit basierend auf einem Unix-Zeitstempel fest

Beschreibung

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

Gibt ein neues DateTimeImmutable-Objekt zurück, das aus dem alten Objekt erstellt wurde, wobei das Datum und die Uhrzeit auf der Basis eines Unix-Zeitstempels gesetzt wurden.

Parameter-Liste

timestamp

Ein Unix-Zeitstempel, der das Datum darstellt. Um Zeitstempel außerhalb des Bereichs von Integer zu setzen, kann die Methode DateTimeImmutable::modify() mit dem @-Format verwendet werden.

Rückgabewerte

Gibt ein neues DateTimeImmutable-Objekt mit den geänderten Daten zurück. Bei einem Fehler wird false zurückgegeben.

Beispiele

Beispiel #1 DateTimeImmutable::setTimestamp()-Beispiel

Objektorientierter Stil

<?php
$date 
= new DateTimeImmutable();
echo 
$date->format('U = Y-m-d H:i:s') . "\n";

$newDate $date->setTimestamp(1171502725);
echo 
$newDate->format('U = Y-m-d H:i:s') . "\n";
?>

Die oben gezeigten Beispiele erzeugen eine ähnliche Ausgabe wie:

1272508903 = 2010-04-28 22:41:43
1171502725 = 2007-02-14 20:25:25

Siehe auch

add a note add a note

User Contributed Notes 2 notes

up
7
ben at hl9 dot net
3 years ago
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.
up
1
Philip
1 year ago
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
?>
To Top