A 4th parameter has been added in PHP-7.1 : microseconds
See the notes here:
https://github.com/php/php-src/blob/e33ec61f9c1baa73bfe1b03b8c48a824ab2a867e/UPGRADING#L285
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTime::setTime -- date_time_set — Legt die Uhrzeit fest
Objektorientierter Stil
Prozeduraler Stil
$object
,$hour
,$minute
,$second
= 0,$microsecond
= 0Ändert die aktuelle Uhrzeit des DateTime-Objekts auf eine andere Uhrzeit.
Wie DateTimeImmutable::setTime(), verwendet aber DateTime und ändert das bestehende Objekt.
Die prozedurale Version verwendet das DateTime-Objekt als ersten Parameter.
object
Nur bei prozeduralem Aufruf: Ein von date_create() zurückgegebenes DateTime-Objekt. Diese Funktion verändert dieses Objekt.
hour
Die Stunde der Uhrzeit.
minute
Die Minute der Uhrzeit.
second
Die Sekunde der Uhrzeit.
microsecond
Die Mikrosekunde der Uhrzeit.
Gibt das geänderte DateTime-Objekt für die Methodenverkettung zurück.
Version | Beschreibung |
---|---|
8.1.0 | Das Verhalten bei doppelt vorhandenen Stunden (während der Umstellung von Sommer- auf Normalzeit) wurde geändert. Bisher wählte PHP die zweite Stundenzahl (nach der Zeitumstellung), statt der ersten (vor der Zeitumstellung). |
7.1.0 |
Der Parameter microsecond wurde hinzugefügt.
|
A 4th parameter has been added in PHP-7.1 : microseconds
See the notes here:
https://github.com/php/php-src/blob/e33ec61f9c1baa73bfe1b03b8c48a824ab2a867e/UPGRADING#L285
Be aware that setTime can cause a change in the timezone offset: https://3v4l.org/MqYN9
(The time 01:05:00 exists twice on this day in Europe/London due to DST change - once in +01:00 and then again at +00:00)
$tzUK = new \DateTimeZone("Europe/London");
$tzUtc = new \DateTimeZone("UTC");
$dt = \DateTimeImmutable::createFromFormat("!Y-m-d H:i:s", "2020-10-25 00:05:00", $tzUtc);
$dt = DateTime::createFromFormat('U', $dt->format('U'));
print $dt->format(\DateTime::RFC3339 ." e") ."\n";
$dt->setTimeZone($tzUK);
print $dt->format(\DateTime::RFC3339 ." e") ."\n";
$dt->setTime((int) $dt->format('H'), (int) $dt->format('i'), 0);
print $dt->format(\DateTime::RFC3339 ." e") ."\n";
Will output:
2020-10-25T00:05:00+00:00 +00:00
2020-10-25T01:05:00+01:00 Europe/London
2020-10-25T01:05:00+00:00 Europe/London
Verified on PHP 5.3 thru 8.0 (latest at time of posting)