date_diff

FunctionParams and return types changed in PHP 8.0

Alias of DateTime::diff.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

date_diff Function synopsis

date_diff(
    DateTimeInterface $baseObject,
    DateTimeInterface $targetObject,
    bool $absolute = false
  ): DateInterval

Parameters

$baseObject

TypeDateTimeInterface

$targetObject

TypeDateTimeInterface

$absolute

OptionalTypeboolDefault valuefalse

Return value

TypeDateInterval

Changes to the date_diff Function

PHP 8.0

  • Return type added: DateInterval
  • Parameter name of parameter #1 changed: $object to $baseObject
  • Parameter type added for parameter #1 ($baseObject): DateTimeInterface
  • Parameter name of parameter #2 changed: $object2 to $targetObject
  • Parameter type added for parameter #2 ($targetObject): DateTimeInterface
  • Parameter type added for parameter #3 ($absolute): bool
  • Parameter default value added for position #3 ($absolute): false
  date_diff(
-     $object,
+     DateTimeInterface $baseObject,
-     $object2,
+     DateTimeInterface $targetObject,
-     $absolute
+     bool $absolute = false
-   )
+   ): DateInterval

date_diff Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes