PHP 8.3.4 Released!

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Возвращает временную метку Unix

Описание

Объектно-ориентированный стиль

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

Процедурный стиль

Возвращает временную метку 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

Смотрите также

add a note

User Contributed Notes

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