Thursday, November 20, 2025
HomeLanguagesPHP | DateTime diff() Function

PHP | DateTime diff() Function

The DateTime::diff() function is an inbuilt function in PHP which is used to return the difference between two given DateTime objects.

Syntax:

  • Object oriented style:
    DateInterval DateTime::diff( DateTimeInterface $datetime2,
                                      bool $absolute = FALSE )

    or

    DateInterval DateTimeImmutable::diff( DateTimeInterface $datetime2,
                                      bool $absolute = FALSE )

    or

    DateInterval DateTimeInterface::diff( DateTimeInterface $datetime2,
                                      bool $absolute = FALSE )
  • Procedural style:
    DateInterval date_diff( DateTimeInterface $datetime1,
                      DateTimeInterface $datetime2, bool $absolute = FALSE )

Parameters: This function uses two parameters as mentioned above and described below:

  • $datetime: This parameter holds the date to compare with first date.
  • $absolute: This parameter forced the interval to be positive.

Return Value: This function return the difference between two given DateTime objects.

Below programs illustrate the DateTime::diff() function in PHP:

Program 1:




<?php
  
// Initialising the two datetime objects
$datetime1 = new DateTime('2019-9-10');
$datetime2 = new DateTime('2019-9-15');
  
// Calling the diff() function on above
// two DateTime objects
$difference = $datetime1->diff($datetime2);
  
// Getting the difference between two
// given DateTime objects
echo $difference->format('%R%a days');
?>


Output:

+5 days

Program 2:




<?php
  
// Initialising the two datetime objects
$datetime1 = new DateTime('2019-8-10');
$datetime2 = new DateTime('2019-9-10');
  
// Calling the diff() function on above
// two DateTime objects
$difference = $datetime1->diff($datetime2);
  
// Getting the difference between two
// given DateTime objects
echo $difference->format('%R%a days');
?>


Output:

+31 days

Reference: https://www.php.net/manual/en/datetime.diff.php

RELATED ARTICLES

Most Popular

Dominic
32404 POSTS0 COMMENTS
Milvus
97 POSTS0 COMMENTS
Nango Kala
6775 POSTS0 COMMENTS
Nicole Veronica
11924 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11994 POSTS0 COMMENTS
Shaida Kate Naidoo
6903 POSTS0 COMMENTS
Ted Musemwa
7159 POSTS0 COMMENTS
Thapelo Manthata
6859 POSTS0 COMMENTS
Umr Jansen
6846 POSTS0 COMMENTS