Define a parte de microssegundos do horário

# DateTimeImmutable::setMicrosecond

(PHP 8 >= 8.4.0)

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

### Descrição

#[\NoDiscard(message: "as DateTimeImmutable::setMicrosecond() does not modify the object itself")]
public function DateTimeImmutable::setMicrosecond(int `$microsecond`): static

Retorna um novo objeto DateTimeImmutable construído a partir do antigo, com a parte de microssegundos modificada.

### Parâmetros

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

### Valor Retornado

Retorna um novo objeto DateTimeImmutable com os dados modificados.

### Erros/Exceções

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

### Exemplos

Exemplo #1 Exemplo de DateTimeImmutable::setMicrosecond()

    <?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;
    ?>

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