Sets microsecond part of the time

# 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

- DateTimeInterface::getMicrosecond() - Gets the microsecond part of the Unix timestamp

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open