array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'datetime.gettimestamp.php', 1 => 'DateTimeInterface::getTimestamp', 2 => 'Obtém o timestamp Unix', ), 'up' => array ( 0 => 'class.datetimeinterface.php', 1 => 'DateTimeInterface', ), 'prev' => array ( 0 => 'datetime.getoffset.php', 1 => 'DateTimeInterface::getOffset', ), 'next' => array ( 0 => 'datetime.gettimezone.php', 1 => 'DateTimeInterface::getTimezone', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/datetime/datetimeinterface/gettimestamp.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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

Estilo orientado a objetos

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

O exemplo acima produzirá algo semelhante a:

1272509157

Estilo procedural

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

O exemplo acima produzirá 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().

Exemplo #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";

O exemplo acima produzirá algo semelhante a:

1674057635586
1674057635586918

Veja Também