PHPCon Poland 2024

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_getLiefert den Unix-Zeitstempel

Beschreibung

Objektorientierter Stil

public DateTimeInterface::getTimestamp(): int
public DateTimeImmutable::getTimestamp(): int
public DateTime::getTimestamp(): int

Prozeduraler Stil

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

Version Beschreibung
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

add a note

User Contributed Notes

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