PHP | funciones date_create(), date_format(), date_add() – Part 1

Hay algún momento en el tiempo en el que necesitamos agregar una cantidad de días, meses, años, horas, minutos y segundos a Fecha y hora. PHP nos sirve con varias funciones integradas para hacer esto. Algunas funciones integradas que discutiremos aquí son date_create(), date_format() y date_add(). 

función date_create()

Esta función se usa para crear un objeto DateTime usando una string de fecha/hora y una zona horaria. El valor predeterminado de la string de fecha/hora es la fecha/hora actual. 
Sintaxis: 

DateTime date_create(time, timezone);

Parámetros: Esta función acepta dos parámetros:  

1. time : (opcional) especifica una string de fecha/hora. NULL o el valor predeterminado 
   indica la fecha/hora actual. Puede consultar este enlace para conocer los formatos de fecha y hora admitidos en PHP.
2. timezone : (opcional) Zona horaria de la hora.

Valor de retorno : esta función devuelve un nuevo objeto DateTime que especifica una fecha. 

función date_format()

La función date_format() formatea una fecha determinada. La fecha se proporciona como una instancia de DateTime que generalmente es devuelta por la función date_create() y el formato es una string según la cual queremos formatear la fecha.
Sintaxis: 

string date_format(object, format);

Parámetros: Esta función acepta dos parámetros, todos ellos de obligatorio suministro. 

1. objeto: Especifica un objeto DateTime devuelto por date_create()
2. formato: especifica el formato de la fecha. Acepta los formatos compatibles con la función date() en PHP. Ejemplo: H (formato de 24 horas), h (formato de 12 horas), i (minutos: 00 a 59), s (segundos: 00 a 59), etc. 
    

Valor devuelto: la función date_format() devuelve una string que representa la fecha formateada de acuerdo con el formato especificado en caso de formateo exitoso; de lo contrario, devuelve falso en caso de falla. 

<?php
 
// using date_create() function to create
// DateTime object
$date=date_create("2018-03-15");
 
// using date_format() function to format date
echo date_format($date, "Y/m/d H:i:s");
 
?>

Producción: 

2018/03/15 00:00:00 

función date_add()

La función date_add() se usa para agregar días, meses, años, horas, minutos y segundos a una Fecha. La fecha se proporciona como un objeto DateTime a la función date_add() y el intervalo que queremos agregar a nuestra fecha se proporciona como un objeto DateInterval.
Sintaxis:  

DateTime date_add(object, interval);

Parámetros: Esta función acepta tres parámetros, todos ellos de obligatorio suministro.  

1. Objeto: Especifica un objeto DateTime devuelto por date_create(). Esta función devuelve un nuevo objeto DateTime.
2. Interval: especifica un objeto DateInterval, es decir, almacena una cantidad fija de tiempo (en años, meses, días, horas, etc.) o una string de tiempo relativa en el formato que admite el constructor de DateTime.

Valor devuelto: esta función devuelve un objeto DateTime en caso de éxito o FALSO en caso de error.
Los siguientes programas ilustran la función date_add() en PHP:
Ejemplo-1 

<?php
 
// PHP program to add 40 days in date
 
$date=date_create("2018-12-10");
 
date_add($date, date_interval_create_from_date_string("40 days"));
 
echo date_format($date, "Y-m-d");
 
?>

Producción:  

2019-01-19

Ejemplo-2 

<?php
 
//PHP program to add 1 year, 10 mins, 23 secs in date
 
$date=date_create("2018-12-10");
 
date_add($date, date_interval_create_from_date_string("1 year
                                      + 10 mins + 23 secs"));
 
echo date_format($date, "Y-m-d H:i:s");
 
?>

Producción: 

2019-12-10 00:10:23

Nota : Usando el operador ‘+’ podemos agregar más a la fecha y la hora.
Referencias : 

• http://php.net/manual/en/datetime.format.php
• http://php.net/manual/en/function.date-add.php
• http://php.net/manual/en/datetime.construct.php