Função date_interval_create_from_date_string

A função date_interval_create_from_date_string converte uma descrição textual de intervalo em um objeto de data. Este objeto pode ser usado com as funções date_add e date_sub. A string de intervalo usa linguagem natural para especificar o período.

Sintaxe

date_interval_create_from_date_string(string $time);

Exemplo

Vamos criar um intervalo de 2 dias e 6 horas:

<?php
	$interval = date_interval_create_from_date_string('2 days + 6 hours');
	print_r($interval);
?>

Resultado da execução do código:

DateInterval Object
(
	[d] => 2
	[h] => 6
)

Exemplo

Vamos criar um intervalo complexo (1 mês, 2 semanas e 3 dias):

<?php
	$interval = date_interval_create_from_date_string('1 month + 2 weeks + 3 days');
	print_r($interval);
?>

Resultado da execução do código:

DateInterval Object
(
	[m] => 1
	[d] => 17
)

Formatos suportados

A função entende as seguintes unidades de medida:

year/years
month/months
day/days
week/weeks
hour/hours
minute/minutes
second/seconds

Veja também

a função date_add,
que adiciona um intervalo a uma data
a função date_sub,
que subtrai um intervalo de uma data
a função date_create,
que cria um objeto DateTime