array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'datetime.createfromformat.php', 1 => 'DateTime::createFromFormat', 2 => 'Interpreta um string de data/horário de acordo com um formato especificado.', ), 'up' => array ( 0 => 'class.datetime.php', 1 => 'DateTime', ), 'prev' => array ( 0 => 'datetime.construct.php', 1 => 'DateTime::__construct', ), 'next' => array ( 0 => 'datetime.createfromimmutable.php', 1 => 'DateTime::createFromImmutable', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/datetime/datetime/createfromformat.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

DateTime::createFromFormat

date_create_from_format

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

DateTime::createFromFormat -- date_create_from_format — Interpreta um string de data/horário de acordo com um formato especificado.

Descrição

Estilo orientado a objetos

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

Estilo procedural

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

Retorna um novo objeto DateTime representando a data e o horário especificados pela string datetime, que foi formatada 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.

Parâmetros

Ver 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ão Descriçã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