Establece la fecha

# 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

### Ver también

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open