In 32-bit system the unix timestamp will overflow if the date goes beyond year 2038 and this method will return false. In 64-bit systems this function will still work as intended. For more information please see http://en.wikipedia.org/wiki/Year_2038_problem.
DateTime::getTimestamp
DateTimeImmutable::getTimestamp
DateTimeInterface::getTimestamp
date_timestamp_get
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTime::getTimestamp -- DateTimeImmutable::getTimestamp -- DateTimeInterface::getTimestamp -- date_timestamp_get — Gets the Unix timestamp
Beschreibung
Objektorientierter Stil
public DateTime::getTimestamp(): int
public DateTimeImmutable::getTimestamp(): int
public DateTimeInterface::getTimestamp(): int
Prozeduraler Stil
Gets the Unix timestamp.
Parameter-Liste
Diese Funktion besitzt keine Parameter.
Rückgabewerte
Returns the Unix timestamp representing the date.
Fehler/Exceptions
If the timestamp cannot be represented as Integer, a ValueError
is thrown. 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.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
These functions no longer return false on failure.
|
Beispiele
Beispiel #1 DateTime::getTimestamp() example
Objektorientierter Stil
<?php
$date = new DateTime();
echo $date->getTimestamp();
?>
Prozeduraler Stil
<?php
$date = date_create();
echo date_timestamp_get($date);
?>
Die oben gezeigten Beispiele erzeugen eine ähnliche Ausgabe wie:
1272509157
Siehe auch
- DateTime::setTimestamp() - Legt Datum und Zeit basierend auf einem Unix-Zeitstempel fest
- DateTime::format() - Returns date formatted according to given format
add a note
User Contributed Notes 4 notes
heiccih at gmail dot com ¶
8 years ago
Justin Heesemann ¶
11 years ago
Note that for dates before the unix epoch getTimestamp() will return false, whereas format("U") will return a negative number.
<?php
$date = new DateTime("1899-12-31");
// "-2209078800"
echo $date->format("U");
// false
echo $date->getTimestamp();
?>
mike at eastghost dot com ¶
1 day ago
Not clearly noted in documentation:
UNIX timestamps are by definition in UTC timezone only: @1234567890 represents the same date/time regardless of timezone.
Therefore, DateTime::getTimestamp() always returns (seconds since epoch) in the UTC timezone, even when DateTime object has its DateTimeZone set to any non-UTC timezone.
To make a 'timestamp' that is local to your server (in any non-UTC timezone), use mktime() and feed it the desired/offset local time components.
Julien Bornstein ¶
2 years ago
Please note that DateTime::gettimestamp() will return an integer, but DateTime::format("U") will return a string.
timestamp must always be typed as int because in PHP, timestamps are integers.
eg:
- strftime ( string $format [, int $timestamp = time() ] ) : string
- time() // return int
- ...
So IMHO, as PHP becomes more and more a typed language, avoid using DateTime::format("U") to avoid this kind of errors "strftime() expects parameter 2 to be int, string given"
