array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'datetimeimmutable.setmicrosecond.php', 1 => 'DateTimeImmutable::setMicrosecond', 2 => 'Sets microsecond part of the time', ), 'up' => array ( 0 => 'class.datetimeimmutable.php', 1 => 'DateTimeImmutable', ), 'prev' => array ( 0 => 'datetimeimmutable.setisodate.php', 1 => 'DateTimeImmutable::setISODate', ), 'next' => array ( 0 => 'datetimeimmutable.settime.php', 1 => 'DateTimeImmutable::setTime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/datetime/datetimeimmutable/setmicrosecond.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

DateTimeImmutable::setMicrosecond

(PHP 8 >= 8.4.0)

DateTimeImmutable::setMicrosecond — Sets microsecond part of the time

Beschreibung

#[\NoDiscard(message: "as DateTimeImmutable::setMicrosecond() does not modify the object itself")]
public function DateTimeImmutable::setMicrosecond(int $microsecond): static

Returns a new DateTimeImmutable object constructed from the old one, with modified microsecond part.

Parameter-Liste

microsecond
The microsecond value to set (0 to 999999).

Rückgabewerte

Gibt ein neues DateTimeImmutable-Objekt mit den geänderten Daten zurück.

Fehler/Exceptions

If the microsecond is outside the range [0, 999999], a DateRangeError is thrown.

Beispiele

Beispiel #1 DateTimeImmutable::setMicrosecond() example

<?php
$date = DateTimeImmutable::createFromTimestamp(123.456789);
echo $date->format('Y-m-d H:i:s.u') . PHP_EOL;
$date = $date->setMicrosecond(987654);
echo $date->format('Y-m-d H:i:s.u') . PHP_EOL;
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

1970-01-01 00:02:03.456789
1970-01-01 00:02:03.987654

Siehe auch