Función PHP date_time_set ()
Definición y uso
los date_time_set()función es un alias de la función DateTime :: setTime () . Con esto, puede (re) establecer la hora de un objeto DateTime.
Sintaxis
date_time_set($object, $hours, $minutes, $seconds, $microseconds)
Parámetros
No Señor | Descripción de parámetros |
---|---|
1 |
object(Mandatory) Este es un objeto DateTime en el que debe establecer la fecha. |
2 |
hours(Mandatory) Este es un valor entero que representa la hora del tiempo que se va a configurar. |
3 |
minute(Mandatory) Este es un valor entero que representa el minuto del tiempo que se va a configurar. |
4 |
seconds(Optional) Este es un valor entero que representa los segundos del tiempo que se configurará. |
5 |
microseconds(Optional) Este es un valor entero que representa los microsegundos del tiempo que se va a configurar. |
Valores devueltos
La función PHP date_time_set () devuelve el objeto DateTime con el valor modificado (hora). En caso de falla, esta función devuelve el valor booleano falso .
Versión PHP
Esta función se introdujo por primera vez en la versión 5.2.0 de PHP y funciona con todas las versiones posteriores.
Ejemplo
El siguiente ejemplo demuestra el uso de la función date_time_set :
<?php
//Creating a date
$date = new DateTime();
//Setting the date
date_time_set($date, 7, 20, 35);
print("Date: ".date_format($date, "Y/m/d H:i:s"));
?>
Esto producirá el siguiente resultado:
Date: 2020/05/10 07:20:35
Ejemplo
El siguiente ejemplo crea un objeto DateTime y modifica su t usando la función date_time_set () . -
<?php
//Date string
$date_string = "25-09-1989 10:42:12";
//Creating a DateTime object
$date_time_Obj = date_create($date_string);
print("Original Date: ".date_format($date_time_Obj, "Y/m/d H:i:s"));
print("\n");
//Setting the date
$date = date_time_set($date_time_Obj, 6, 36, 3 );
print("Modified Date: ".date_format($date, "Y/m/d H:i:s"));
?>
Esto producirá el siguiente resultado:
Original Date: 1989/09/25 10:42:12
Modified Date: 1989/09/25 06:36:03
Ejemplo
Al invocar esta función, si pasa los valores de día y mes que exceden su rango, se agregarán a sus valores principales:
<?php
//Creating a date
$date = new DateTime();
//Setting the date
date_time_set($date, 24, 15, 36);
print("Date: ".date_format($date, "Y/m/d H:i:s"));
?>
Dado que hemos establecido el valor del mes en 15. Se agregan tres meses al tiempo apropiado -
Date: 2020/05/11 00:15:36
Ejemplo
$dateSrc = '2007-04-19 12:50 GMT';
$dateTime = date_create( $dateSrc);;
$retval = date_time_set( $dateTime, 20, 40, 10);
echo 'DateTime::format(): '.$dateTime->format('Y:M:D:H:i:s');
echo "\n";
# Using second function.
$dateTime = new DateTime($dateSrc);
$retval = $dateTime->setTime(20, 56,6);
echo 'DateTime::format(): '.$dateTime->format('Y:M:D:H:i:s');
Esto producirá el siguiente resultado:
DateTime::format(): 2007:Apr:Thu:20:40:10
DateTime::format(): 2007:Apr:Thu:20:56:06