DateTime::setMicrosecond

(PHP 8 >= 8.4.0)

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

Descrição

public function DateTime::setMicrosecond(int $microsecond): static

Define a parte de microssegundos do horário.

Funciona como em DateTimeImmutable::setMicrosecond(), porém com DateTime.

Parâmetros

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

Valor Retornado

Retorna o objeto DateTime modificado para encadeamento de métodos.

Erros/Exceções

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

Exemplos

Exemplo #1 Exemplo de DateTime::setMicrosecond()

<?php
$date = DateTime::createFromTimestamp(123.456789);
echo $date->format('Y-m-d H:i:s.u') . PHP_EOL;
$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