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

DateTimeImmutable::__construct() - Liefert ein neues DateTimeImmutable-Objekt

add a note

User Contributed Notes 1 note

down

php3779 ¶

9 months ago


it says the default parameter is 'now'.

but it also uses 'now' when you enter an empty string like '' despite it being a valid datetime format, expected an exception.

add a note