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

# 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

### 参考

- DateTimeInterface::getMicrosecond() - Unix タイムスタンプのマイクロ秒部分を取得する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open