Função PHP date_modify ()

Definição e Uso

o date_modify()function é um alias de DateTime :: modify (). Esta função é usada para modificar a data em um objeto DateTime. Ele altera o registro de data e hora do objeto fornecido.

Sintaxe

date_modify($object, $modify)

Parâmetros

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

object (Mandatory)

Isso representa o objeto DateTime que você deseja modificar.

2

modify (Mandatory)

Esta é uma string de data / hora especificando a modificação necessária.

Valores Retornados

A função PHP date_modify () retorna o objeto DateTime com o valor modificado. 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.2.0 e funciona com todas as versões posteriores.

Exemplo

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

<?php
   //Modifying the date
   $date = date_modify(new DateTime(), "+15 day");   
   print("Date: ".date_format($date, "Y/m/d"));
?>

Isso produzirá o seguinte resultado -

Date: 2020/05/21

Exemplo

O exemplo a seguir cria um objeto DateTime e modifica sua data usando a função date_modify () . -

<?php
   //Creating a DateTime object
   $date_time_Obj = date_create("25-09-1989");
   print("Original Date: ".date_format($date_time_Obj, "Y/m/d"));
   print("\n");
   //Setting the date
   $date = date_modify($date_time_Obj, "+15 years 7 months 23 days" );   
   print("Modified Date: ".date_format($date, "Y/m/d"));
?>

Isso produzirá o seguinte resultado -

Original Date: 1989/09/25
Modified Date: 2005/05/18

Exemplo

Você também pode modificar uma data especificando o número de semanas como -

<?php
   //Creating a DateTime object
   $date_time_Obj = date_create("25-09-1989");
   print("Original Date: ".date_format($date_time_Obj, "Y/m/d"));
   print("\n");
   //Setting the date
   $date = date_modify($date_time_Obj, "1960 weeks" );   
   print("Modified Date: ".date_format($date, "Y/m/d"));
?>

Isso produzirá a seguinte saída -

Original Date: 1989/09/25
Modified Date: 2027/04/19

Exemplo

<?php
   $date = new DateTime("1990-12-12");
   $date->modify("+1 day");
   
   echo $date->format("Y-m-d");
?>

Isso produzirá a seguinte saída -

1990-12-13