PHP 8.4.2 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-эпохи для заданной даты.

Ошибки

Метод выбросит исключение DateRangeError, если не получится представить метку времени целым числом (int). До 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

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

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top