PHP | DateTime add() Function

0 0 1 minute read

The DateTime::add() function is an inbuilt function in PHP which is used to add an amount of time (days, months, years, hours, minutes and seconds) to the given DateTime object.

Syntax:

Object oriented style:

DateTime DateTime::add( DateInterval $interval )

Procedural style:

DateTime date_add( DateTime $object, DateInterval $interval )

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

$object: It specifies the DateTime object returned by date_create() function. This function returns a new DateTime object.
$interval: This parameter holds the DateInterval object.

Return Value: This function returns the new DateTime object after changing on success or False on failure.

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

Program 1:

<?php 
  
// Initialising a DateTime 
$datetime = new DateTime('2019-09-30'); 
  
// DateInterval object is taken as the  
// parameter of the add() function 
// Here 1 day is added 
$datetime->add(new DateInterval('P1D')); 
  
// Getting the new date after addition 
echo $datetime->format('Y-m-d') . "\n"; 
?> 

Output:

2019-10-01

Program 2:

<?php 
  
// Initialising a DateTime 
$datetime = new DateTime('2019-09-30'); 
  
// DateInterval object is taken as the  
// parameter of the add() function 
// Here 5 hours, 3 Minutes and 10 seconds is added 
$datetime->add(new DateInterval('PT5H3M10S')); 
  
// Getting the new date after addition 
echo $datetime->format('Y-m-d H:i:s') . "\n"; 
?> 