Legt das Datum fest

# DateTimeImmutable::setDate

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

DateTimeImmutable::setDate — Legt das Datum fest

### Beschreibung

#[\NoDiscard]
public function DateTimeImmutable::setDate(int `$year`, int `$month`, int `$day`): DateTimeImmutable

Gibt ein neues DateTimeImmutable-Objekt zurück, bei dem das aktuelle Datum des DateTimeImmutable-Objekts auf das angegebene Datum gesetzt wurde.

### Parameter-Liste

`object`

  Nur bei prozeduralem Aufruf: Ein von date_create() zurückgegebenes DateTime-Objekt. Diese Funktion verändert dieses Objekt.

`year`

  Das Jahr des Datums

`month`

  Der Monat des Datums

`day`

  Der Tag des Datums

### Rückgabewerte

Gibt ein neues DateTimeImmutable-Objekt mit den geänderten Daten zurück.

### Beispiele

Beispiel #1 DateTimeImmutable::setDate()-Beispiel

Objektorientierter Stil

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    2001-02-03

Beispiel #2 Werte, die einen Bereich überschreiten, werden zu ihren übergeordneten Werten hinzugefügt

    <?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";

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

### Siehe auch

- DateTimeImmutable::setISODate() - Legt das ISO-Datum fest
- DateTimeImmutable::setTime() - Legt die Uhrzeit fest

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