DateTimeImmutable::setDate
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::setDate — Legt das Datum fest
Beschreibung
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. Bei einem Fehler wird false zurückgegeben.
Beispiele
Beispiel #1 DateTimeImmutable::setDate()-Beispiel
Objektorientierter Stil
<?php
$date = new DateTimeImmutable();
$newDate = $date->setDate(2001, 2, 3);
echo $newDate->format('Y-m-d');
?>
Die obigen Bespiele erzeugen 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
