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_getGets the Unix timestamp

Опис

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

public DateTimeInterface::getTimestamp(): int
public DateTimeImmutable::getTimestamp(): int
public DateTime::getTimestamp(): int

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

Gets the Unix timestamp.

Параметри

У цієї функції немає параметрів.

Значення, що повертаються

Returns the Unix timestamp representing the date.

Помилки/виключення

If the timestamp cannot be represented as int, a DateRangeError is thrown. Prior to PHP 8.3.0, a ValueError is thrown. And, prior to PHP 8.0.0, false was returned in this case. Still, the timestamp can be retrieved as string by using DateTimeInterface::format() with the U format.

Журнал змін

Версія Опис
8.3.0 The out-of-range exception is now DateRangeError.
8.0.0 These functions no longer return false on failure.

Приклади

Приклад #1 DateTime::getTimestamp() example

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

<?php
$date
= new DateTimeImmutable();
echo
$date->getTimestamp();
?>

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

<?php
$date
= date_create();
echo
date_timestamp_get($date);
?>

Подані вище приклади виведуть щось схоже на:

1272509157

If you need to retrieve the timestamp with millisecond or microsecond resolution, then you can use the DateTimeInterface::format() function.

Приклад #2 Retrieving timestamp with milli and microsecond resolution

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

<?php
$date
= new DateTimeImmutable();
$milli = (int) $date->format('Uv'); // Timestamp in milliseconds
$micro = (int) $date->format('Uu'); // Timestamp in microseconds

echo $milli, "\n", $micro, "\n";
?>

Подані вище приклади виведуть щось схоже на:

1674057635586
1674057635586918

Прогляньте також

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top