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

    Описание

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

    publicDateTimeInterface::getTimestamp(): int
    publicDateTimeImmutable::getTimestamp(): int
    publicDateTime::getTimestamp(): int

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

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

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

    To Top