array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'datetime.gettimestamp.php', 1 => 'DateTimeInterface::getTimestamp', 2 => 'Возвращает метку времени с начала эпохи Unix', ), 'up' => array ( 0 => 'class.datetimeinterface.php', 1 => 'DateTimeInterface', ), 'prev' => array ( 0 => 'datetime.getoffset.php', 1 => 'DateTimeInterface::getOffset', ), 'next' => array ( 0 => 'datetime.gettimezone.php', 1 => 'DateTimeInterface::getTimezone', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/datetime/datetimeinterface/gettimestamp.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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

date_timestamp_get(DateTimeInterface $object): 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();

Вывод приведённого примера будет похож на: 

1272509157

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

<?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

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