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

参见