Função PHP date_date_set ()

Definição e Uso

o date_date_set()função é um alias de DateTime :: setDate () . Usando isso, você pode (re) definir a data de um objeto DateTime.

Sintaxe

date_date_set($object, $year, $month, $day)

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

year(Mandatory)

Este é um valor inteiro que representa o ano de uma data.

3

month(Mandatory)

Este é um valor inteiro que representa o mês de uma data.

4

day(Mandatory)

Este é um valor inteiro que representa o dia de uma data.

Valores Retornados

A função PHP date_date_set () 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_date_set -

<?php
   //Creating a date
   $date = new DateTime();
   //Setting the date
   date_date_set($date, 2019, 07, 17);   
   print("Date: ".date_format($date, "Y/m/d"));
?>

Isso produzirá o seguinte resultado -

Date: 2019/07/17

Exemplo

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

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

Isso produzirá o seguinte resultado -

Original Date: 1989/09/25
Modified Date: 2015/11/25

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_date_set($date, 2019, 15, 17);   
   print("Date: ".date_format($date, "Y/m/d"));
?>

Uma vez que definimos o valor do mês como 15. Três meses são adicionados à data apropriada -

Date: 2020/03/17

Exemplo

$dateSrc = '2005-04-19 12:50 GMT';
$dateTime = date_create( $dateSrc);;
# Now set a new date using date_date_set();
date_date_set( $dateTime, 2000, 12, 12);
   
echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");
echo "
"; # Using second function. $dateTime = new DateTime($dateSrc); $dateTime->setDate( 1999, 10, 12); echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");

Isso produzirá o seguinte resultado -

New Formatted date is 2000-12-12T12:50:00Z
New Formatted date is 1999-10-12T12:50:00Z