array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), '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

Опис

#[\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.

Параметри

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

Значення, що повертаються

Повертає новий об'єкт DateTimeImmutable зі зміненими даними.

Помилки/виключення

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

Приклади

Приклад #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;
?>

Поданий вище приклад виведе:

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

Прогляньте також