Função PHP date_add ()

Definição e Uso

A função date_add () é um alias de DateTime :: add () . Ele aceita um objeto DateTime como parâmetros e um objeto DateInterval, adiciona o intervalo especificado ao DateTime fornecido.

Sintaxe

date_add($object, $interval)

Parâmetros

Sr. Não Parâmetro e Descrição
1

object(Optional)

Este é um objeto DateTime especificando / representando a data à qual você precisa adicionar o intervalo de tempo.

2

interval (Optional)

Este é um objeto DateInterval que especifica o intervalo a ser adicionado.

Valores Retornados

A função PHP date_add () retorna um objeto DateTime com intervalo adicionado. Em caso de falha, esta função retorna o valor booleano falso .

Versão PHP

Esta função foi introduzida pela primeira vez no PHP versão 5.3.0 e funciona com todas as versões posteriores.

Exemplo

O exemplo a seguir demonstra o uso da função date_add () -

<?php
   //Creating a DateTime object
   $date = date_create("25-09-1989");
   //Adding interval to the date
   $res = date_add($date, new DateInterval('PT10H30S'));   
   //formatting the date to print it
   $format = date_format( $res, "d-m-Y H:i:s");
   print($format);
?>

Isso produzirá o seguinte resultado -

25-09-1989 10:00:30

Exemplo

Você pode criar um intervalo usando a função date_interval_create_from_date_string () . O exemplo a seguir cria um intervalo usando esta função, adiciona-o a uma data -

<?php
   $date = date_create("25-09-1989");
   $interval = date_interval_create_from_date_string('1025 days');
   $res = date_add($date, $interval);   
   $format = date_format( $res, "d-m-Y H:i:s");
   print($format);   
?>

Isso produzirá o seguinte resultado -

16-07-1992 00:00:00

Exemplo

Agora, vamos tentar adicionar intervalo com anos, meses e dias -

<?php
   //Creating a DateTime object
   $date = date_create("25-09-1989");
   //Adding interval to the date
   $res = date_add($date, new DateInterval('P29Y2M5D'));   
   //formatting the date to print it
   $format = date_format( $res, "d-m-Y");
   print($format);
?>

Isso produzirá o seguinte resultado -

30-11-2018

Exemplo

<?php
   $date = date_create('1995-05-07');
   $interval = date_interval_create_from_date_string('150 days');
   $date->add($interval);
   print($date -> format('d-m-Y'));
?>

Isso produz o seguinte resultado -

04-10-1995