DateTimeImmutable::setMicrosecond

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#
Véase también#

Establece la parte de microsegundos de la hora

Descripción#

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

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 de DateTimeImmutable::setMicrosecond

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

```php

El ejemplo anterior mostrará:

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

Véase también#

DateTimeInterface::getMicrosecond