Função PHP date_time_set ()
Definição e Uso
o date_time_set()function é um alias da função DateTime :: setTime () . Usando isso, você pode (re) definir a hora de um objeto DateTime.
Sintaxe
date_time_set($object, $hours, $minutes, $seconds, $microseconds)
Parâmetros
Sr. Não | Parâmetro e Descrição |
---|---|
1 | object(Mandatory) Este é um objeto DateTime para o qual você precisa definir a data. |
2 | hours(Mandatory) Este é um valor inteiro que representa a hora da hora a ser definida. |
3 | minute(Mandatory) Este é um valor inteiro que representa o minuto do tempo a ser definido. |
4 | seconds(Optional) Este é um valor inteiro que representa os segundos do tempo a ser definido. |
5 | microseconds(Optional) Este é um valor inteiro que representa os microssegundos do tempo a ser definido. |
Valores Retornados
A função PHP date_time_set () retorna o objeto DateTime com o valor modificado (hora). 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_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"));
?>
Isso produzirá o seguinte resultado -
Date: 2020/05/10 07:20:35
Exemplo
O exemplo a seguir cria um objeto DateTime e modifica seu t usando a função 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"));
?>
Isso produzirá o seguinte resultado -
Original Date: 1989/09/25 10:42:12
Modified Date: 1989/09/25 06:36:03
Exemplo
Ao invocar esta função, se você passar os valores de dia e mês excedendo seu intervalo, eles serão adicionados aos seus valores pais -
<?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"));
?>
Uma vez que definimos o valor do mês como 15. Três meses são adicionados ao tempo apropriado -
Date: 2020/05/11 00:15:36
Exemplo
$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');
Isso produzirá o seguinte resultado -
DateTime::format(): 2007:Apr:Thu:20:40:10
DateTime::format(): 2007:Apr:Thu:20:56:06