DateTime::createFromFormat

date_create_from_format

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

DateTime::createFromFormat -- date_create_from_formatInterpreta um string de data/hora de acordo com um formato especificado.

Descrição

Estilo orientado a objetos

publicstaticDateTime::createFromFormat(string$format, string$datetime, ?DateTimeZone$timezone = null): DateTime|false

Estilo procedural

Retorna um novo objeto DateTime representando a data e a hora especificadas pelo string datetime, que foi formatado de acordo com o parâmetro format fornecido.

Equivalente a DateTimeImmutable::createFromFormat() e date_create_immutable_from_format(), respectivamente, mas cria um objeto DateTime.

Este método, incluindo parâmetros, exemplos e considerações estão documentados na página DateTimeImmutable::createFromFormat.

Valor Retornado

Retorna uma nova instância de DateTime ou false em caso de falha.

Erros/Exceções

Este método dispara uma exceção ValueError quando o parâmetro datetime contém bytes nulos.

Registro de Alterações

VersãoDescrição
8.0.21, 8.1.8, 8.2.0 Agora dispara ValueError quando bytes nulos são passados pelo parâmetro datetime, o que antes era silencioamente ignorado.

Exemplos

Para um conjunto extenso de exemplos, veja DateTimeImmutable::createFromFormat.

Veja Também

To Top