Função date_interval_format() do PHP

Exemplo

Calcular a diferença entre duas datas e formatar o intervalo de tempo:

<?php
$date1=date_create("1984-01-28");
$date2=date_create("1980-10-15");
$diff=date_diff($date1,$date2);
// %a exibe o total de dias
echo $diff->format("Total de dias:%a.");
?>

Exemplo de Execução

Definição e Uso

A função date_interval_format() é sinônimo de DateInterval::format().

A função DateInterval::format() é usada para formatar intervalos de tempo.

Sintaxe

DateInterval::format(format);
Parâmetros Descrição
format

Obrigatório. Especificar o formato. A string do parâmetro format pode usar os seguintes caracteres:

  • % - Literal %
  • Y - Ano, pelo menos 2 dígitos, com zero à esquerda (por exemplo, 03)
  • y - Ano (por exemplo, 3)
  • M - Mês, com zero à esquerda (por exemplo, 06)
  • m - Mês (por exemplo, 6)
  • D - Dia, com zero à esquerda (por exemplo, 09)
  • d - Dia (por exemplo, 9)
  • a - O total de dias entre as duas datas calculadas por date_diff()
  • H - Horas, com zero à esquerda (por exemplo, 08, 23)
  • h - Horas (por exemplo, 8, 23)
  • I - Minutos, com zero à esquerda (por exemplo, 08, 23)
  • i - Minutos (por exemplo, 8, 23)
  • S - Segundos, com zero à esquerda (por exemplo, 08, 23)
  • s - Segundos (por exemplo, 8, 23)
  • R - Quando negativo, é o sinal "-", quando positivo, é o sinal "+"
  • r - Quando negativo, é o sinal "-", quando positivo, está vazio

Comentário:Cada string de formato deve começar com o símbolo %!

Detalhes Técnicos

Retorno: Retorna o intervalo de tempo formatado.
Versão PHP: 5.3+