(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTimeInterface::getTimestamp -- DateTimeImmutable::getTimestamp -- DateTime::getTimestamp -- date_timestamp_get — Возвращает временную метку Unix
Объектно-ориентированный стиль
Процедурный стиль
Возвращает временную метку Unix.
У этой функции нет параметров.
Возвращает временную метку Unix для указанной даты.
Если не получится представить временную метку целым числом (int),
будет выброшено исключение DateRangeError.
До PHP 8.3.0 выбрасывалось исключение ValueError.
А до PHP 8.0.0 возвращалось логическое значение false
. При этом
метку времени можно получить в виде строки (string),
вызвав метод DateTimeInterface::format()
с параметром форматирования U
.
Версия | Описание |
---|---|
8.3.0 | Теперь при выходе за пределы диапазона будет выброшено исключение DateRangeError. |
8.0.0 |
Функции больше не возвращают значение false в случае возникновения ошибки.
|
Пример #1 Пример использования DateTime::getTimestamp()
Объектно-ориентированный стиль
<?php
$date = new DateTimeImmutable();
echo $date->getTimestamp();
?>
Процедурный стиль
<?php
$date = date_create();
echo date_timestamp_get($date);
?>
Вывод приведённых примеров будет похож на:
1272509157
Если необходимо получить метку времени с миллисекундами или микросекундами, можно использовать функцию DateTimeInterface::format().
Пример #2 Получение метки времени с милли- и микросекундами
Объектно-ориентированный стиль
<?php
$date = new DateTimeImmutable();
$milli = (int)$date->format('Uv'); // Метка времени с миллисекундами
$micro = (int)$date->format('Uu'); // Метка времени с микросекундами
echo $milli, "\n", $micro, "\n";
?>
Вывод приведённых примеров будет похож на:
1674057635586 1674057635586918