Sintaxe para a função date_time_set()
A sintaxe do date_time_set() função em PHP é dada abaixo.
Data hora date_time_set ( Data hora $objeto , int $ hora , int $ minuto , int $ segundo = 0 , int $ microssegundo = 0 )Os parâmetros da função são:
- $objeto: O objeto DateTime a ser modificado.
- $ hora : O novo valor para o componente de hora.
- $minuto: O novo valor para o componente minuto.
- $segundo: (Opcional) O novo valor para o segundo componente. O padrão é 0.
- $microssegundo: (Opcional) O novo valor para o componente de microssegundo. O padrão é 0.
Esses valores devem estar no formato de string, com a hora formatada no formato de 24 horas.
Valor de retorno
Um novo objeto DateTime com os componentes de hora atualizados é retornado pelo date_time_set() método. O objeto DateTime principal permanece inalterado.
Observação: Vale notar que o date_time_set() A função não modifica o objeto DateTime original, em vez disso, ela retorna um novo objeto DateTime com a data e hora especificadas. Isso significa que, se você deseja atualizar um objeto DateTime com um novo valor de hora, precisa atribuir o valor de retorno do date_time_set() função de volta para o objeto DateTime original.
Por exemplo:
$data = novo Data hora ( '2023-12-01 00:00:00' ) ;
date_time_set ( $data , 12 , 30 ) ;
imprimir ( 'Data: ' . Formato de data ( $data , 'S/m/d H:i:s' ) ) ;
?>
Neste exemplo, a primeira linha cria um novo objeto DateTime com a data definida como 1º de dezembro de 2023 à meia-noite. A segunda linha usa o date_time_set() para definir a hora do objeto como 12h30 e atribuir o objeto DateTime resultante de volta ao $data variável.
Se você passar valores de dia e mês fora do intervalo permitido ao chamar este método, eles serão adicionados aos seus valores pais.
$data = novo Data hora ( ) ;
date_time_set ( $ data , 24 , 22 , 36 ) ;
imprimir ( 'Data: ' . Formato de data ( $ data , 'S/m/d H:i:s' ) ) ;
?>
Um novo objeto DateTime que reflete a data e hora atuais é criado pelo código acima. A hora do objeto DateTime é então definida como 24 horas, 22 minutos e 36 segundos usando o date_time_set() método. O Formato de data() O método é então usado para formatar e imprimir a data e hora alteradas.
Conclusão
O date_time_set() A função em PHP fornece uma maneira conveniente de definir ou modificar os componentes de tempo de um objeto DateTime. Ao usar essa função, os desenvolvedores podem alterar facilmente os componentes de hora, minuto, segundo e microssegundo de um objeto DateTime. O date_time_set() A função oferece flexibilidade e precisão ao lidar com modificações de tempo, tornando-a uma ferramenta valiosa para trabalhar com datas e horas em aplicativos PHP.