DateTimeImmutable::__construct
date_create_immutable
Liefert ein neues DateTimeImmutable-Objekt
&reftitle.description;
&style.oop;
public DateTimeImmutable::__construct
stringdatetime"now"
DateTimeZonenulltimezone&null;
&style.procedural;
DateTimeImmutablefalsedate_create_immutable
stringdatetime"now"
DateTimeZonenulltimezone&null;
Gibt ein neues DateTimeImmutable-Objekt zurück.
&reftitle.parameters;
datetime
&date.formats.parameter;
Wenn der Parameter $timezone verwendet wird, kann
hier mit der Übergabe von "now" die aktuelle Zeit
ermittelt werden.
timezone
Ein DateTimeZone-Objekt, das die Zeitzone von
$datetime darstellt.
Wenn $timezone nicht übergeben wird oder &null;
ist, wird die aktuelle Zeitzone verwendet.
Der Parameter $timezone und die aktuelle
Zeitzone werden ignoriert, wenn der Parameter
$datetime entweder ein UNIX-Zeitstempel ist
(&zb; @946684800) oder eine Zeitzone vorgibt (&zb;
2010-01-28T15:00:00+02:00 oder
2010-07-05T06:00:00Z).
&reftitle.returnvalues;
Gibt eine neue DateTimeImmutable-Instanz zurück.
&reftitle.errors;
Wenn eine ungültige Datum/Uhrzeit-Zeichenkette übergeben wird, wird eine
DateMalformedStringException geworfen. Vor
PHP 8.3 wird eine Exception geworfen.
&reftitle.changelog;
&Version;
&Description;
8.3.0
Wirft nun eine
DateMalformedStringException anstelle
von Exception, wenn eine ungültige
Zeichenkette übergeben wird.
7.1.0
Von nun an werden die Mikrosekunden mit dem aktuellen Wert belegt,
nicht mit '00000'.
&reftitle.examples;
DateTimeImmutable::__construct-Beispiel
&style.oop;
getMessage();
exit(1);
}
echo $date->format('Y-m-d');
?>
]]>
&style.procedural;
]]>
&examples.outputs;
Die Besonderheiten von DateTimeImmutable::__construct
format('Y-m-d H:i:sP') . "\n";
// Datums- und Zeitangaben in der angegebenen Zeitzone.
$date = new DateTimeImmutable('2000-01-01', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// Aktuelles Datum und aktuelle Uhrzeit in der Zeitzone des Computers.
$date = new DateTimeImmutable();
echo $date->format('Y-m-d H:i:sP') . "\n";
// Aktuelles Datum und aktuelle Uhrzeit in der angegebenen Zeitzone.
$date = new DateTimeImmutable('now', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// Verwendung eines UNIX-Zeitstempels. Zu beachten ist,
// dass das Ergebnis in der Zeitzone UTC liegt.
$date = new DateTimeImmutable('@946684800');
echo $date->format('Y-m-d H:i:sP') . "\n";
// Nicht vorhandene Werte werden fortgeschrieben.
$date = new DateTimeImmutable('2000-02-30');
echo $date->format('Y-m-d H:i:sP') . "\n";
?>
]]>
&example.outputs.similar;
Ändern der zugehörigen Zeitzone
setTimezone($timeZone);
echo $time->format('Y/m/d H:i:s'), "\n";
?>
]]>
&example.outputs.similar;
Verwenden einer Zeichenkette mit relativen Datums- und Zeitangaben
format('Y/m/d H:i:s'), "\n";
?>
]]>
&example.outputs.similar;