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