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

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы