DateTime::__construct

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

DateTime::__construct — Retorna um novo objeto DateTime

Descrição

public DateTime::__construct(string $datetime = "now", ?DateTimeZone $timezone = null)

Equivalente a DateTimeImmutable::__construct() mas funciona com DateTime. Considere usar DateTimeImmutable e suas caracterísitcas.

Retorna um novo objeto DateTime.

Parâmetros

datetime

Uma string de data/hora. Os formatos válidos são explicados em Formatos de Data e Hora.

Coloque "now" neste parâmetro para obter o horário atual quando utilizar o parâmetro $timezone.

timezone

Um objeto DateTimeZone, representando o fuso horário do parâmetro $datetime.

Se $timezone for null ou omitido, o fuso horário atual será utilizado.

Note:

O parâmetro $timezone e o fuso horário atual são ignorados quando o parâmetro $datetime é um timestamp UNIX (exemplo, @946684800) ou quando o fuso horário é informado (exemplo. 2010-01-28T15:00:00+02:00).

Valor Retornado

Retorna uma nova instância de DateTime.

Erros/Exceções

Se uma string inválida de data/hora for passada, uma exceção DateMalformedStringException é disparada. Antes do PHP 8.3, era uma Exception.

Registro de Alterações

Versão Descrição
8.3.0 Agora dispara DateMalformedStringException se uma string inválida é passada, em vez de Exception.

Veja Também