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 — Obtém o timestamp Unix

Descrição

Estilo orientado a objetos

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

Estilo procedural

date_timestamp_get(DateTimeInterface $object): int

Obtém o timestamp Unix.

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

Retorna o timestamp Unix que representa a data.

Erros/Exceções

Se o timestamp não puder ser representado como um int, uma exceção DateRangeError é disparada. Antes do PHP 8.3.0, uma exceção ValueError era disparada. E, antes do PHP 8.0.0, false era retornado neste caso. Ainda, o timestamp pode ser recuperado como string usando o método DateTimeInterface::format() com o formato literal U.

Registro de Alterações

Versão Descrição
8.3.0 A exceção fora do intervalo é agora DateRangeError.
8.0.0 Esta função não mais retorna false em caso de falha.

Exemplos

Example #1 Exemplo do método DateTime::getTimestamp()

Estilo orientado a objetos

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

Estilo procedural

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

Os exemplos acima produzirão algo semelhante a:

1272509157

Se for necessário recuperar o timestamp com resolução de milissegundos ou microssegundos, pode ser utilizada a função DateTimeInterface::format().

Example #2 Recuperando o timestamp com resolução de mili e microssegundos

Estilo orientado a objetos

<?php
$date = new DateTimeImmutable();
$mili = (int) $date->format('Uv'); // Timestamp em milissegundos
$micro = (int) $date->format('Uu'); // Timestamp em microssegundos

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

Os exemplos acima produzirão algo semelhante a:

1674057635586
1674057635586918

Veja Também