PHP 8.4.22 Released!

DateTimeImmutable::setMicrosecond

(PHP 8 >= 8.4.0)

DateTimeImmutable::setMicrosecondSets 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

参见

添加备注

用户贡献的备注

此页面尚无用户贡献的备注。
To Top