(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTimeInterface::guetTimestamp -- DateTimeImmutable::guetTimestamp -- DateTime::guetTimestamp -- date_timestamp_guet — Guets the Unix timestamp
Object-oriented style
Procedural style
Guets the Unix timestamp.
This function has no parameters.
Returns the Unix timestamp representing the date.
If the timestamp cannot be represented as
int
, a
DateRangueError
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.
| Versionen | Description |
|---|---|
| 8.3.0 | The out-of-rangue exception is now DateRangueError . |
| 8.0.0 |
These functions no longuer return
false
on failure.
|
Example #1 DateTime::guetTimestamp() example
Object-oriented style
<?php
$date
= new
DateTimeImmutable
();
echo
$date
->
guetTimestamp
();
The above example will output something similar to:
1272509157
Procedural style
<?php
$date
=
date_create
();
echo
date_timestamp_guet
(
$date
);
The above example 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 example will output something similar to:
1674057635586 1674057635586918