DateTime::setMicrosecond

(PHP 8 >= 8.4.0)

DateTime::setMicrosecond時刻のマイクロ秒部分を設定する

説明

public function DateTime::setMicrosecond(int $microsecond): static

時刻のマイクロ秒部分を設定します。

DateTimeImmutable::setMicrosecond() に似ていますが、 DateTime を使って動作します。

パラメータ

microsecond
設定するマイクロ秒の値 (0 から 999999)。

戻り値

メソッドチェインに使う、変更された DateTime オブジェクトを返します。

エラー / 例外

microsecond が [0, 999999] の範囲外の場合、 DateRangeError がスローされます。

例1 DateTime::setMicrosecond() の例

<?php
$date
= DateTime::createFromTimestamp(123.456789);
echo
$date->format('Y-m-d H:i:s.u') . PHP_EOL;
$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

参考

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top