Establece la parte de microsegundos de la hora

# DateTimeImmutable::setMicrosecond

(PHP 8 >= 8.4.0)

DateTimeImmutable::setMicrosecond — Establece la parte de microsegundos de la hora

### Descripción

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

Devuelve un nuevo objeto DateTimeImmutable construido a partir del antiguo, con la parte de microsegundos modificada.

### Parámetros

`microsecond`
  El valor de microsegundos a establecer (de `0` a `999999`).

### Valores devueltos

Retorna un nuevo objeto DateTimeImmutable con los datos modificados.

### Errores/Excepciones

Si `microsecond` está fuera del rango [`0`, `999999`], se lanza una DateRangeError.

### Ejemplos

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

El ejemplo anterior mostrará:

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

### Ver también

- DateTimeInterface::getMicrosecond() - Obtiene la parte de microsegundos de la marca de tiempo Unix

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