Définit la partie microseconde de l'heure

# DateTimeImmutable::setMicrosecond

(PHP 8 >= 8.4.0)

DateTimeImmutable::setMicrosecond — Définit la partie microseconde de l'heure

### Description

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

Retourne un nouvel objet DateTimeImmutable construit à partir de l'ancien, avec la partie microseconde modifiée.

### Liste de paramètres

`microsecond`
  La valeur de microseconde à définir (`0` à `999999`).

### Valeurs de retour

Retourne un nouvel objet DateTimeImmutable avec les données modifiées.

### Erreurs / Exceptions

Si `microsecond` est en dehors de l'intervalle [`0`, `999999`], une DateRangeError est lancée.

### Exemples

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

L'exemple ci-dessus va afficher :

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

### Voir aussi

- DateTimeInterface::getMicrosecond() - Récupère la partie microseconde de l'horodatage Unix

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