PHP 8.4.22 Released!

DateTime::setMicrosecond

(PHP 8 >= 8.4.0)

DateTime::setMicrosecondSets microsecond part of the time

Description

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

Sets microsecond part of the time.

Like DateTimeImmutable::setMicrosecond() but works with DateTime.

Parameters

microsecond
The microsecond value to set (0 to 999999).

Return Values

Returns the modified DateTime object for method chaining.

Errors/Exceptions

If the microsecond is outside the range [0, 999999], a DateRangeError is thrown.

Examples

Example #1 DateTime::setMicrosecond() example

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

The above example will output:

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

See Also

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top