array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'datetime.construct.php', 1 => 'DateTime::__construct', 2 => 'Liefert ein neues DateTime-Objekt', ), 'up' => array ( 0 => 'class.datetime.php', 1 => 'DateTime', ), 'prev' => array ( 0 => 'datetime.add.php', 1 => 'DateTime::add', ), 'next' => array ( 0 => 'datetime.createfromformat.php', 1 => 'DateTime::createFromFormat', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/datetime/datetime/construct.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

DateTime::__construct

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

DateTime::__construct — Liefert ein neues DateTime-Objekt

Beschreibung

public DateTime::__construct(string $datetime = "now", ?DateTimeZone $timezone = null)

Wie DateTimeImmutable::__construct(), verwendet aber DateTime. Es sollte in Betracht gezogen werden, die Klasse DateTimeImmutable und deren Features zu verwenden.

Gibt ein neues DateTime-Objekt zurück.

Parameter-Liste

datetime

Ein Datums/Zeit Zeichenkette. Gültige Formate werden unter Datums- und Zeitformate erläutert.

Wenn der Parameter $timezone verwendet wird, kann hier mit der Übergabe von "now" die aktuelle Zeit ermittelt werden.

timezone

Ein DateTimeZone-Objekt, welches die Zeitzone von $datetime repräsentiert.

Wenn $timezone nicht übergeben wird oder null ist, wird die aktuelle Zeitzone verwendet.

Hinweis:

Der Parameter $timezone und die aktuelle Zeitzone werden ignoriert, wenn der Parameter $datetime entweder ein UNIX-Zeitstempel ist (z. B. @946684800), oder wenn in ihm eine Zeitzone spezifiziert wird (z. B. 2010-01-28T15:00:00+02:00).

Rückgabewerte

Gibt eine neue Instanz von DateTime zurück.

Fehler/Exceptions

Wenn eine ungültige Datum/Uhrzeit-Zeichenkette übergeben wird, wird eine DateMalformedStringException geworfen. Vor PHP 8.3 wird eine Exception geworfen.

Changelog

Version Beschreibung
8.3.0 Wirft nun eine DateMalformedStringException anstelle von Exception, wenn eine ungültige Zeichenkette übergeben wird.

Siehe auch