array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'datetime.gettimestamp.php', 1 => 'DateTimeInterface::getTimestamp', ), 'up' => array ( 0 => 'class.datetimeinterface.php', 1 => 'DateTimeInterface', ), 'prev' => array ( 0 => 'datetime.getoffset.php', 1 => 'DateTimeInterface::getOffset', ), 'next' => array ( 0 => 'datetime.gettimezone.php', 1 => 'DateTimeInterface::getTimezone', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/datetime/datetimeinterface/gettimestamp.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTimeInterface::getTimestamp -- DateTimeImmutable::getTimestamp -- DateTime::getTimestamp -- date_timestamp_get — Gets the Unix timestamp
Object-oriented style
Procedural style
Gets the Unix timestamp.
This function has no parameters.
Returns the Unix timestamp representing the date.
If the timestamp cannot be represented as int, a
DateRangeError is thrown. Prior to PHP
8.3.0, a ValueError is thrown. And, prior to
PHP 8.0.0, false
was returned in this case. Still, the timestamp can be
retrieved as string by using
DateTimeInterface::format() with the
U
format.
Version | Description |
---|---|
8.3.0 | The out-of-range exception is now DateRangeError. |
8.0.0 |
These functions no longer return false on failure.
|
Example #1 DateTime::getTimestamp() example
Object-oriented style
<?php
$date = new DateTimeImmutable();
echo $date->getTimestamp();
?>
Procedural style
<?php
$date = date_create();
echo date_timestamp_get($date);
?>
The above examples will output something similar to:
1272509157
If you need to retrieve the timestamp with millisecond or microsecond resolution, then you can use the DateTimeInterface::format() function.
Example #2 Retrieving timestamp with milli and microsecond resolution
Object-oriented style
<?php
$date = new DateTimeImmutable();
$milli = (int)$date->format('Uv'); // Timestamp in milliseconds
$micro = (int)$date->format('Uu'); // Timestamp in microseconds
echo $milli, "\n", $micro, "\n";
?>
The above examples will output something similar to:
1674057635586 1674057635586918