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 function DateTimeInterface::getTimestamp(): int

public function DateTimeImmutable::getTimestamp(): int

public function DateTime::getTimestamp(): int

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

function 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

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

DateTime::setTimestamp() - Устанавливает дату и время на основе метки времени Unix
DateTimeImmutable::setTimestamp() - Устанавливает дату и время на основе метки времени Unix
DateTimeInterface::format() - Форматирует дату в заданном формате

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

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

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