DateTime::setDate

date_date_set

(PHP 5 >= 5.2.0, PHP 7)

DateTime::setDate -- date_date_set — Establece la fecha

Descripción

Estilo orientado a objetos

public DateTime::setDate ( int $year , int $month , int $day ) : DateTime

Estilo por procedimientos

date_date_set ( DateTime $object , int $year , int $month , int $day ) : DateTime

Reinicia la fecha actual del objeto DateTime a una fecha diferente.

Parámetros

object

Solamente para el estilo por procedimientos: Un objeto DateTime devuelto por date_create(). La función modifica este objeto.

year

Año de la fecha.

month

Mes de la fecha.

day

Día de la fecha.

Valores devueltos

Devuelve el objeto DateTime para la cadena de métodos o FALSE en caso de error.

Historial de cambios

Versión Descripción
5.3.0Se ha cambiado el valor devuelto en caso de éxito de NULL a DateTime.

Ejemplos

Ejemplo #1 Ejemplo de DateTime::setDate()

Estilo orientado a objetos

<?php
$fecha = new DateTime();
$fecha->setDate(2001, 2, 3);
echo $fecha->format('Y-m-d');
?>

Estilo por procedimientos

<?php
$fecha = date_create();
date_date_set($fecha, 2001, 2, 3);
echo date_format($fecha, 'Y-m-d');
?>

El resultado de los ejemplos sería:

2001-02-03

Ejemplo #2 Los valores que exceden rangos son añadidos a sus valores padre

<?php
$fecha = new DateTime();

$fecha->setDate(2001, 2, 28);
echo $fecha->format('Y-m-d') . "\n";

$fecha->setDate(2001, 2, 29);
echo $fecha->format('Y-m-d') . "\n";

$fecha->setDate(2001, 14, 3);
echo $fecha->format('Y-m-d') . "\n";
?>

El resultado del ejemplo sería:

2001-02-28
2001-03-01
2002-02-03

Ver también