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 для цієї дати.

Помилки

Якщо не вийде представити тимчасову мітку цілим числом (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()****

Об'єктно-орієнтований стиль

Loading...
▶

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

Loading...
▶

Висновок наведених прикладів буде схожим на:

1272509157

Якщо потрібно отримати мітку часу з мілісекундами або мікросекундами, можна використовувати функцію DateTimeInterface::format()

Приклад #2 Отримання мітки часу з мілі- та мікросекундами

Об'єктно-орієнтований стиль

Loading...
▶

Висновок наведених прикладів буде схожим на:

1674057635586
1674057635586918

Дивіться також

• DateTime::setTimestamp() - Встановлює дату та час на основі мітки часу Unix
• DateTimeImmutable::setTimestamp() - Встановлює дату та час на основі мітки часу Unix
• DateTimeInterface::format() - Повертає дату, відформатовану згідно з переданим форматом