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
32541 POSTS0 COMMENTS
Milvus
131 POSTS0 COMMENTS
Nango Kala
6920 POSTS0 COMMENTS
Nicole Veronica
12036 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12143 POSTS0 COMMENTS
Shaida Kate Naidoo
7055 POSTS0 COMMENTS
Ted Musemwa
7292 POSTS0 COMMENTS
Thapelo Manthata
7014 POSTS0 COMMENTS
Umr Jansen
7000 POSTS0 COMMENTS