DateTimeImmutable::setDate

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

DateTimeImmutable::setDate — Establece la fecha

Descripción

#[\NoDiscard(message: "as DateTimeImmutable::setDate() does not modify the object itself")]
public function DateTimeImmutable::setDate(int $year, int $month, int $day): DateTimeImmutable

Devuelve un nuevo objeto DateTimeImmutable con la fecha actual del objeto DateTimeImmutable establecida a la fecha dada.

Parámetros

object: Solo en estilo procedimental: Un objeto DateTime retornado por la función date_create() . Esta función modifica este objeto.
year: Año de la fecha.
month: Mes de la fecha.
day: Día de la fecha.

Valores devueltos

Retorna un nuevo objeto DateTimeImmutable con los datos modificados.

Ejemplos

Ejemplo #1 Ejemplo de DateTimeImmutable::setDate()

Estilo orientado a objetos

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

El ejemplo anterior mostrará:

2001年02月03日

Ejemplo #2 Valores que exceden los rangos se añaden a sus valores padres

<?php
$date = new DateTimeImmutable();
$newDate = $date->setDate(2001, 2, 28);
echo $newDate->format('Y-m-d') . "\n";
$newDate = $date->setDate(2001, 2, 29);
echo $newDate->format('Y-m-d') . "\n";
$newDate = $date->setDate(2001, 14, 3);
echo $newDate->format('Y-m-d') . "\n";

El ejemplo anterior mostrará:

2001年02月28日
2001年03月01日
2002年02月03日

Véase también

DateTimeImmutable::setISODate() - Establece la fecha ISO
DateTimeImmutable::setTime() - Establece la hora

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes

There are no user contributed notes for this page.