Define a parte de microssegundos do horário

# DateTime::setMicrosecond

(PHP 8 >= 8.4.0)

DateTime::setMicrosecond — Define a parte de microssegundos do horário

### Descrição

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

Define a parte de microssegundos do horário.

Funciona como em DateTimeImmutable::setMicrosecond(), porém com DateTime.

### Parâmetros

`microsecond`
  O valor de microssegundos a ser definido (`0` a `999999`).

### Valor Retornado

Retorna o objeto DateTime modificado para encadeamento de métodos.

### Erros/Exceções

Se `microsecond` estiver fora do intervalo [`0`, `999999`], uma DateRangeError é lançada.

### Exemplos

Exemplo #1 Exemplo de 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;
    ?>

O exemplo acima produzirá:

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

### Veja Também

- DateTimeInterface::getMicrosecond() - Obtém a parte de microssegundos do timestamp Unix

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