Método setTimestamp da classe DateTime

O método setTimestamp do objeto DateTime permite definir a data e hora, usando um Unix timestamp (o número de segundos decorridos desde 1 de janeiro de 1970). O método modifica o objeto de data existente e o retorna para encadeamento de chamadas.

Sintaxe

phppublic DateTime::setTimestamp(int $timestamp): DateTime

Exemplo

Vamos definir a data correspondente ao timestamp 1609459200 (1 de janeiro de 2021, 00:00:00 UTC):

php<?php
  $date = new DateTime();
  $date->setTimestamp(1609459200);
  echo $date->format('Y-m-d H:i:s');
?>

Resultado da execução do código:

php'2021-01-01 00:00:00'

Exemplo

Uso em cadeia de métodos:

php<?php
  $date = (new DateTime())->setTimestamp(1609459200);
  echo $date->format('Y-m-d');
?>

Resultado da execução do código:

php'2021-01-01'

Exemplo

Definindo a hora atual:

php<?php
  $date = new DateTime();
  $date->setTimestamp(time());
  echo $date->format('H:i:s');
?>

Exibirá a hora atual, por exemplo:

php'14:25:36'

Veja também

  • a função date,
    que formata um Unix timestamp
  • o método setDate,
    que define a data por partes
  • o método getTimestamp,
    que obtém o Unix timestamp do objeto DateTime