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.

Nota:
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

DateTimeImmutable::__construct() - Retorna um novo objeto DateTimeImmutable

add a note

User Contributed Notes 1 note

down

php3779 ¶

10 months ago


it says the default parameter is 'now'.

but it also uses 'now' when you enter an empty string like '' despite it being a valid datetime format, expected an exception.

add a note