In 32-bit system the unix timestamp will overflow if the date goes beyond year 2038 and this method will return false. In 64-bit systems this function will still work as intended. For more information please see http://en.wikipedia.org/wiki/Year_2038_problem.
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
Estilo procedural
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();
?>Estilo procedural
<?php
$date = date_create();
echo date_timestamp_get($date);
?>Os exemplos acima produzirão algo semelhante a:
1272509157
Se você precisa recuperar o timestamp com resolução de milissegundos ou microssegundos, você pode uitilizar 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";
?>Os exemplos acima produzirão algo semelhante a:
1674057635586 1674057635586918
Veja Também
- DateTime::setTimestamp() - Define a data e hora baseada em um timestamp Unix
- DateTimeImmutable::setTimestamp() - Define a data e o horário com base em um timestamp Unix
- DateTimeInterface::format() - Retorna a data formatada de acordo com um formato informado
add a note
User Contributed Notes 3 notes
heiccih at gmail dot com ¶
10 years ago
Justin Heesemann ¶
14 years ago
Note that for dates before the unix epoch getTimestamp() will return false, whereas format("U") will return a negative number.
<?php
$date = new DateTime("1899-12-31");
// "-2209078800"
echo $date->format("U");
// false
echo $date->getTimestamp();
?>
Julien Bornstein ¶
4 years ago
Please note that DateTime::gettimestamp() will return an integer, but DateTime::format("U") will return a string.
timestamp must always be typed as int because in PHP, timestamps are integers.
eg:
- strftime ( string $format [, int $timestamp = time() ] ) : string
- time() // return int
- ...
So IMHO, as PHP becomes more and more a typed language, avoid using DateTime::format("U") to avoid this kind of errors "strftime() expects parameter 2 to be int, string given"
