Устанавливает микросекундную часть времени

# DateTimeImmutable::setMicrosecond

(PHP 8 >= 8.4.0)

DateTimeImmutable::setMicrosecond — Устанавливает микросекундную часть времени

### Описание

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

Возвращает новый объект DateTimeImmutable, построенный на основе старого, с изменённой микросекундной частью.

### Список параметров

`microsecond`
  Значение микросекунд для установки (от `0` до `999999`).

### Возвращаемые значения

Метод возвращает новый объект DateTimeImmutable с модифицированными данными.

### Ошибки

Если значение микросекунд `microsecond` выходит за пределы диапазона [`0`, `999999`], выбрасывается исключение DateRangeError.

### Примеры

Пример #1 Пример использования метода DateTimeImmutable::setMicrosecond()

    <?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;
    ?>

Результат выполнения приведённого примера:

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

### Смотрите также

- DateTimeInterface::getMicrosecond() - Получает микросекундную часть метки времени Unix

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