Função date_diff

A função date_diff encontra a diferença entre duas datas. As datas, por sua vez, devem ser objetos criados pela função date_create. A função retorna um objeto 'data', que pode ser formatado usando o método format.

Sintaxe

phpdate_diff(DateTimeInterface $base, DateTimeInterface $target, bool $absolute = false): DateInterval

Exemplo

Vamos encontrar a diferença em dias entre 2025-12-31 e 2026-01-05:

php<?php
  $date1 = date_create('2025-12-31');
  $date2 = date_create('2026-01-05');
  
  $diff = date_diff($date1, $date2);
  echo $diff->format('%a dias');
?>

Resultado da execução do código:

php5 dias

Veja também

  • a função date_modify,
    que adiciona ou subtrai intervalos de tempo de uma data