DateTime::setTime

date_time_set

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

DateTime::setTime -- date_time_setDefine o horário

Descrição

Estilo orientado a objetos

public DateTime::setTime(
    int $hour,
    int $minute,
    int $second = 0,
    int $microsecond = 0
): DateTime

Estilo procedural

date_time_set(
    DateTime $object,
    int $hour,
    int $minute,
    int $second = 0,
    int $microsecond = 0
): DateTime

Redefine o horário atual do objeto DateTime para um diferente.

Equivalente a DateTimeImmutable::setTime() mas funciona com DateTime.

A versão procedural usa o objeto DateTime como seu primeiro argumento.

Parâmetros

object

Somente no estilo procedural: Um objeto DateTime retornado por date_create(). A função modifica este objeto.

hour

Horas do horário.

minute

Minutos do horário.

second

Segundos do horário.

microsecond

Microssegundos do horário.

Valor Retornado

Retorna o objeto DateTime modificado para encadeamento de métodos.

Registro de Alterações

Versão Descrição
8.1.0 O comportamento com duplicidade de horários existentes (durante um retorno de horário de verão) mudou. Anteriormente, o PHP pegaria a segunda ocorrência (depois do retorno do horário de verão), em vez da primeira ocorrência (antes do retorno do horário de verão).
7.1.0 O parâmetro microsecond foi adicionado.

Veja Também