DateTimeImmutable::__construct
date_create_immutable
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::__construct -- date_create_immutable — Liefert ein neues DateTimeImmutable-Objekt
Beschreibung
Objektorientierter Stil
Prozeduraler Stil
$datetime = "now", ?DateTimeZone $timezone = null): DateTimeImmutable|falseGibt ein neues DateTimeImmutable-Objekt zurück.
Parameter-Liste
-
datetime -
Ein Datums/Zeit Zeichenkette. Gültige Formate werden unter Datums- und Zeitformate erläutert.
Wenn der Parameter
$timezoneverwendet wird, kann hier mit der Übergabe von"now"die aktuelle Zeit ermittelt werden. -
timezone -
Ein DateTimeZone-Objekt, das die Zeitzone von
$datetimedarstellt.Wenn
$timezonenicht übergeben wird odernullist, wird die aktuelle Zeitzone verwendet.Hinweis:
Der Parameter
$timezoneund die aktuelle Zeitzone werden ignoriert, wenn der Parameter$datetimeentweder ein UNIX-Zeitstempel ist (z.B.@946684800) oder eine Zeitzone vorgibt (z.B.2010-01-28T15:00:00+02:00oder2010-07-05T06:00:00Z).
Rückgabewerte
Gibt eine neue DateTimeImmutable-Instanz zurück.
Prozeduraler Stil Im Fehlerfall wird false zurückgegeben.
Fehler/Exceptions
Löst bei einem Fehler eine Exception aus.
Changelog
| Version | Beschreibung |
|---|---|
| 7.1.0 | Von nun an werden die Mikrosekunden mit dem aktuellen Wert belegt, nicht mit '00000'. |
Beispiele
Beispiel #1 DateTimeImmutable::__construct()-Beispiel
Objektorientierter Stil
<?php
try {
$date = new DateTimeImmutable('2000-01-01');
} catch (Exception $e) {
echo $e->getMessage();
exit(1);
}
echo $date->format('Y-m-d');
?>
Prozeduraler Stil
<?php
$date = date_create('2000-01-01');
if (!$date) {
$e = date_get_last_errors();
foreach ($e['errors'] as $error) {
echo "$error\n";
}
exit(1);
}
echo date_format($date, 'Y-m-d');
?>
Die obigen Bespiele erzeugen folgende Ausgabe:
2000-01-01
Beispiel #2 Die Besonderheiten von DateTimeImmutable::__construct()
<?php
// Datums- und Zeitangaben in der Zeitzone des Computers.
$date = new DateTimeImmutable('2000-01-01');
echo $date->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(null, 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";
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
2000-01-01 00:00:00-05:00 2000-01-01 00:00:00+12:00 2010-04-24 10:24:16-04:00 2010-04-25 02:24:16+12:00 2000-01-01 00:00:00+00:00 2000-03-01 00:00:00-05:00
Beispiel #3 Ändern der zugehörigen Zeitzone
<?php
$timeZone = new \DateTimeZone('Asia/Tokyo');
$time = new \DateTimeImmutable();
$time = $time->setTimezone($timeZone);
echo $time->format('Y/m/d H:i:s'), "\n";
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
2022/08/12 23:49:23
Beispiel #4 Verwenden einer Zeichenkette mit relativen Datums- und Zeitangaben
<?php
$time = new \DateTimeImmutable("-1 year");
echo $time->format('Y/m/d H:i:s'), "\n";
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
2021/08/12 15:43:51
