DateTimeInterface::getTimestamp

    DateTimeImmutable::getTimestamp

    DateTime::getTimestamp

    date_timestamp_get

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    DateTimeInterface::getTimestamp -- DateTimeImmutable::getTimestamp -- DateTime::getTimestamp -- date_timestamp_get — Liefert den Unix-Zeitstempel

    Beschreibung

    Objektorientierter Stil

    publicDateTimeInterface::getTimestamp(): int
    publicDateTimeImmutable::getTimestamp(): int
    publicDateTime::getTimestamp(): int

    Prozeduraler Stil

    date_timestamp_get(DateTimeInterface$object): int

    Gibt den Unix-Zeitstempel zurück.

    Parameter-Liste

    Diese Funktion besitzt keine Parameter.

    Rückgabewerte

    Gibt den Unix-Zeitstempel zurück, der das Datum darstellt.

    Fehler/Exceptions

    Wenn der Zeitstempel nicht als Integer dargestellt werden kann, wird ein DateRangeError geworfen. Vor PHP 8.3.0 wird ein ValueError geworfen und vor PHP 8.0.0 wurde in diesem Fall false zurückgegeben. Wenn DateTimeInterface::format() mit dem Format U verwendet wird, kann der Zeitstempel trotzdem als String abgerufen werden.

    Changelog

    VersionBeschreibung
    8.3.0 Die Exception für das Verlassen eines Wertebereichs (out-of-range) heißt nun DateRangeError.
    8.0.0 Diese Funktionen geben bei einem Fehler nicht mehr false zurück.

    Beispiele

    Beispiel #1 DateTime::getTimestamp()-Beispiel

    Objektorientierter Stil

    <?php
    $date     = new DateTimeImmutable();
    echo     $date->getTimestamp();
    ?>

    Prozeduraler Stil

    <?php
    $date     = date_create();
    echo     date_timestamp_get($date);
    ?>

    Oben gezeigte Beispiele erzeugen eine ähnliche Ausgabe wie:

    1272509157

    Wenn der Zeitstempel mit einer Auflösung im Milli- oder Mikrosekundenbereich benötigt wird, kann die Funktion DateTimeInterface::format() verwendet werden.

    Beispiel #2 Auslesen des Zeitstempels mit einer Auflösung im Milli- und Mikrosekundenbereich

    Objektorientierter Stil

    <?php
    $date     = new DateTimeImmutable();
    $milli = (int)$date->format('Uv'); // Zeitstempel in Millisekunden
    $micro = (int)$date->format('Uu'); // Zeitstempel in Mikrosekunden

    echo $milli, "\n", $micro, "\n";
    ?>

    Oben gezeigte Beispiele erzeugen eine ähnliche Ausgabe wie:

    1674057635586 1674057635586918

    Siehe auch

    To Top