PHP | Función add() DateTimeImmutable

La función DateTimeImmutable::add() es una función incorporada en PHP que se usa para agregar una cantidad de días, meses, años, horas, minutos y segundos a un objeto DateTimeImmutable creado.

Sintaxis:

DateTimeImmutable DateTimeImmutable::add( DateInterval $interval )

Parámetros: esta función acepta un solo parámetro $intervalo que contiene la cantidad de días, meses, años, horas, minutos o segundos que se agregarán al objeto DateTimeImmutable dado.

Valores devueltos: esta función devuelve el objeto DateTimeImmutable final después de realizar la adición.

Los siguientes programas ilustran la función DateTimeImmutable::add() en PHP:

Programa 1: este programa utiliza la función DateTimeImmutable::add() para agregar 2 días al objeto DateTimeImmutable.

<?php
// PHP program to illustrate DateTimeImmutable::add()
// function
    
// Creating a new DateTimeImmutable::add() object
$datetime = new DateTimeImmutable("2019-10-03T10:00:00");
  
// Initializing a date interval of 2 days
$interval = 'P2D';
  
// Calling the add() function
$datetime = $datetime->add(new DateInterval($interval));
  
// Getting a new date time in the
// format of 'Y-m-d H:i:s'
echo $datetime->format('Y-m-d H:i:s');
?>

2019-10-05 10:00:00

Programa 2: este programa utiliza la función DateTimeImmutable::add() para agregar ‘P2Y5M2DT0H30M40S’ DateInterval al objeto DateTimeImmutable.

<?php
// PHP program to illustrate DateTimeImmutable::add()
// function
    
// Creating a new DateTimeImmutable::add() object
$datetime = new DateTimeImmutable("2019-10-03T10:00:00");
  
// Initializing a DateInterval object
$interval = 'P2Y5M2DT0H30M40S';
  
// Calling the add() function
$datetime = $datetime->add(new DateInterval($interval));
  
// Getting a new date time in the
// format of 'Y-m-d H:i:s'
echo $datetime->format('Y-m-d H:i:s');
?>

2022-03-05 10:30:40

Referencia: https://www.php.net/manual/en/datetimeimmutable.add.php