diff --git a/reference/datetime/datetime/createfromtimestamp.xml b/reference/datetime/datetime/createfromtimestamp.xml new file mode 100644 index 000000000..218a1d8bc --- /dev/null +++ b/reference/datetime/datetime/createfromtimestamp.xml @@ -0,0 +1,96 @@ + + + + + DateTime::createFromTimestamp + Erzeugt eine Instanz aus einem Unix-Zeitstempel + + + + &reftitle.description; + + public static staticDateTime::createFromTimestamp + intfloattimestamp + + + + Erzeugt eine Instanz aus einem Unix-Zeitstempel. + + + + + &reftitle.parameters; + + + + timestamp + + + Ein Unix-Zeitstempel, der das Datum angibt. + Es wird auch ein &float;-Wert akzeptiert, der eine Genauigkeit im + Mikrosekundenbereich ermöglicht. + + + + + + + + + &reftitle.returnvalues; + + Gibt eine neue DateTime-Instanz zurück. + + + + + &reftitle.errors; + + Wenn der timestamp außerhalb des Bereichs + [PHP_INT_MIN, PHP_INT_MAX] liegt, + wird ein DateRangeError geworfen. + + + + + &reftitle.examples; + + <methodname>DateTime::createFromTimestamp</methodname>-Beispiel + +format('Y-m-d H:i:s.u'); +?> +]]> + + &example.outputs; + + + + + + + + diff --git a/reference/datetime/datetime/setmicrosecond.xml b/reference/datetime/datetime/setmicrosecond.xml new file mode 100644 index 000000000..1a5b954c9 --- /dev/null +++ b/reference/datetime/datetime/setmicrosecond.xml @@ -0,0 +1,110 @@ + + + + + DateTime::setMicrosecond + Setzt den Mikrosekundenanteil der Zeit + + + + &reftitle.description; + + public staticDateTime::setMicrosecond + intmicrosecond + + + + Setzt den Mikrosekundenanteil der Zeit. + + + Wie DateTimeImmutable::setMicrosecond, arbeitet + aber mit DateTime. + + + + + &reftitle.parameters; + + + + microsecond + + + Der zu setzende Mikrosekundenwert (0 bis + 999999). + + + + + + + + + &reftitle.returnvalues; + + &date.datetime.return.modifiedobject; + + + + + &reftitle.errors; + + Wenn der microsecond außerhalb des Bereichs + [0, 999999] liegt, wird ein + DateRangeError geworfen. + + + + + &reftitle.examples; + + <methodname>DateTime::setMicrosecond</methodname>-Beispiel + + +format('Y-m-d H:i:s.u') . PHP_EOL; +$date->setMicrosecond(987654); +echo $date->format('Y-m-d H:i:s.u') . PHP_EOL; +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + DateTimeInterface::getMicrosecond + + + + + diff --git a/reference/datetime/datetime/settimestamp.xml b/reference/datetime/datetime/settimestamp.xml index 263a3645c..42aae29c4 100644 --- a/reference/datetime/datetime/settimestamp.xml +++ b/reference/datetime/datetime/settimestamp.xml @@ -1,6 +1,5 @@ - - + @@ -66,6 +65,7 @@ &reftitle.seealso; DateTimeImmutable::setTimestamp + DateTime::setMicrosecond diff --git a/reference/datetime/datetimeimmutable/add.xml b/reference/datetime/datetimeimmutable/add.xml index de6c2d568..514b1e141 100644 --- a/reference/datetime/datetimeimmutable/add.xml +++ b/reference/datetime/datetimeimmutable/add.xml @@ -1,5 +1,5 @@ - + @@ -13,7 +13,7 @@ &reftitle.description; - #[\NoDiscard] + #[\NoDiscard(message: "as DateTimeImmutable::add() does not modify the object itself")] public DateTimeImmutableDateTimeImmutable::add DateIntervalinterval diff --git a/reference/datetime/datetimeimmutable/createfromtimestamp.xml b/reference/datetime/datetimeimmutable/createfromtimestamp.xml new file mode 100644 index 000000000..5c0dee610 --- /dev/null +++ b/reference/datetime/datetimeimmutable/createfromtimestamp.xml @@ -0,0 +1,96 @@ + + + + + DateTimeImmutable::createFromTimestamp + Erzeugt eine Instanz aus einem Unix-Zeitstempel + + + + &reftitle.description; + + public static staticDateTimeImmutable::createFromTimestamp + intfloattimestamp + + + + Erzeugt eine Instanz aus einem Unix-Zeitstempel. + + + + + &reftitle.parameters; + + + + timestamp + + + Ein Unix-Zeitstempel, der das Datum angibt. + Es wird auch ein &float;-Wert akzeptiert, der eine Genauigkeit im + Mikrosekundenbereich ermöglicht. + + + + + + + + + &reftitle.returnvalues; + + Gibt eine neue DateTimeImmutable-Instanz zurück. + + + + + &reftitle.errors; + + Wenn der timestamp außerhalb des Bereichs + [PHP_INT_MIN, PHP_INT_MAX] liegt, + wird ein DateRangeError geworfen. + + + + + &reftitle.examples; + + <methodname>DateTimeImmutable::createFromTimestamp</methodname>-Beispiel + +format('Y-m-d H:i:s.u'); +?> +]]> + + &example.outputs; + + + + + + + + diff --git a/reference/datetime/datetimeimmutable/modify.xml b/reference/datetime/datetimeimmutable/modify.xml index 4e9cbc01b..d10526048 100644 --- a/reference/datetime/datetimeimmutable/modify.xml +++ b/reference/datetime/datetimeimmutable/modify.xml @@ -1,5 +1,5 @@ - + @@ -10,7 +10,7 @@ &reftitle.description; - #[\NoDiscard] + #[\NoDiscard(message: "as DateTimeImmutable::modify() does not modify the object itself")] public DateTimeImmutableDateTimeImmutable::modify stringmodifier @@ -61,6 +61,13 @@ + + 8.4.0 + + Hat nun einen vorläufigen Rückgabetyp von DateTimeImmutable. + Zuvor war es DateTimeImmutablefalse. + + 8.3.0 diff --git a/reference/datetime/datetimeimmutable/setdate.xml b/reference/datetime/datetimeimmutable/setdate.xml index 4a00b1ea4..6e94030f0 100644 --- a/reference/datetime/datetimeimmutable/setdate.xml +++ b/reference/datetime/datetimeimmutable/setdate.xml @@ -1,5 +1,5 @@ - + @@ -10,7 +10,7 @@ &reftitle.description; - #[\NoDiscard] + #[\NoDiscard(message: "as DateTimeImmutable::setDate() does not modify the object itself")] public DateTimeImmutableDateTimeImmutable::setDate intyear intmonth diff --git a/reference/datetime/datetimeimmutable/setisodate.xml b/reference/datetime/datetimeimmutable/setisodate.xml index 87b9e1181..95674b55a 100644 --- a/reference/datetime/datetimeimmutable/setisodate.xml +++ b/reference/datetime/datetimeimmutable/setisodate.xml @@ -1,5 +1,5 @@ - + @@ -10,7 +10,7 @@ &reftitle.description; - #[\NoDiscard] + #[\NoDiscard(message: "as DateTimeImmutable::setISODate() does not modify the object itself")] public DateTimeImmutableDateTimeImmutable::setISODate intyear intweek diff --git a/reference/datetime/datetimeimmutable/setmicrosecond.xml b/reference/datetime/datetimeimmutable/setmicrosecond.xml new file mode 100644 index 000000000..b0e9207d9 --- /dev/null +++ b/reference/datetime/datetimeimmutable/setmicrosecond.xml @@ -0,0 +1,107 @@ + + + + + DateTimeImmutable::setMicrosecond + Setzt den Mikrosekundenanteil der Zeit + + + + &reftitle.description; + + #[\NoDiscard(message: "as DateTimeImmutable::setMicrosecond() does not modify the object itself")] + public staticDateTimeImmutable::setMicrosecond + intmicrosecond + + + + Gibt ein neues DateTimeImmutable-Objekt zurück, das aus dem + alten erzeugt wird und einen geänderten Mikrosekundenanteil hat. + + + + + &reftitle.parameters; + + + + microsecond + + + Der zu setzende Mikrosekundenwert (0 bis + 999999). + + + + + + + + + &reftitle.returnvalues; + + &date.datetimeimmutable.return.modifiedobject; + + + + + &reftitle.errors; + + Wenn der microsecond außerhalb des Bereichs + [0, 999999] liegt, wird ein + DateRangeError geworfen. + + + + + &reftitle.examples; + + <methodname>DateTimeImmutable::setMicrosecond</methodname>-Beispiel + +format('Y-m-d H:i:s.u') . PHP_EOL; +$date = $date->setMicrosecond(987654); +echo $date->format('Y-m-d H:i:s.u') . PHP_EOL; +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + DateTimeInterface::getMicrosecond + + + + + diff --git a/reference/datetime/datetimeimmutable/settime.xml b/reference/datetime/datetimeimmutable/settime.xml index 3f3bf0d00..29ca341e5 100644 --- a/reference/datetime/datetimeimmutable/settime.xml +++ b/reference/datetime/datetimeimmutable/settime.xml @@ -1,5 +1,5 @@ - + @@ -10,7 +10,7 @@ &reftitle.description; - #[\NoDiscard] + #[\NoDiscard(message: "as DateTimeImmutable::setTime() does not modify the object itself")] public DateTimeImmutableDateTimeImmutable::setTime inthour intminute diff --git a/reference/datetime/datetimeimmutable/settimestamp.xml b/reference/datetime/datetimeimmutable/settimestamp.xml index dd0d18c7e..2e4ea5f8d 100644 --- a/reference/datetime/datetimeimmutable/settimestamp.xml +++ b/reference/datetime/datetimeimmutable/settimestamp.xml @@ -1,5 +1,5 @@ - + @@ -10,7 +10,7 @@ &reftitle.description; - #[\NoDiscard] + #[\NoDiscard(message: "as DateTimeImmutable::setTimestamp() does not modify the object itself")] public DateTimeImmutableDateTimeImmutable::setTimestamp inttimestamp @@ -74,6 +74,7 @@ echo $newDate->format('U = Y-m-d H:i:s') . "\n"; &reftitle.seealso; DateTimeImmutable::getTimestamp + DateTimeImmutable::setMicrosecond diff --git a/reference/datetime/datetimeimmutable/settimezone.xml b/reference/datetime/datetimeimmutable/settimezone.xml index 281619c35..ecb7ce437 100644 --- a/reference/datetime/datetimeimmutable/settimezone.xml +++ b/reference/datetime/datetimeimmutable/settimezone.xml @@ -1,5 +1,5 @@ - + @@ -10,7 +10,7 @@ &reftitle.description; - #[\NoDiscard] + #[\NoDiscard(message: "as DateTimeImmutable::setTimezone() does not modify the object itself")] public DateTimeImmutableDateTimeImmutable::setTimezone DateTimeZonetimezone diff --git a/reference/datetime/datetimeimmutable/sub.xml b/reference/datetime/datetimeimmutable/sub.xml index 77295f896..594e2eeaa 100644 --- a/reference/datetime/datetimeimmutable/sub.xml +++ b/reference/datetime/datetimeimmutable/sub.xml @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@ &reftitle.description; - #[\NoDiscard] + #[\NoDiscard(message: "as DateTimeImmutable::sub() does not modify the object itself")] public DateTimeImmutableDateTimeImmutable::sub DateIntervalinterval diff --git a/reference/datetime/datetimeinterface/getmicrosecond.xml b/reference/datetime/datetimeinterface/getmicrosecond.xml new file mode 100644 index 000000000..4879fab2b --- /dev/null +++ b/reference/datetime/datetimeinterface/getmicrosecond.xml @@ -0,0 +1,94 @@ + + + + + DateTimeInterface::getMicrosecond + DateTimeImmutable::getMicrosecond + DateTime::getMicrosecond + Liefert den Mikrosekundenanteil des Unix-Zeitstempels + + + + &reftitle.description; + + public intDateTimeInterface::getMicrosecond + + + + public intDateTimeImmutable::getMicrosecond + + + + public intDateTime::getMicrosecond + + + + Liefert den Mikrosekundenanteil des Unix-Zeitstempels. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Gibt den Mikrosekundenanteil des Unix-Zeitstempels zurück, der das Datum + darstellt. + + + + + &reftitle.examples; + + <methodname>DateTimeInterface::getMicrosecond</methodname>-Beispiel + +format('u')); +var_dump($date->getMicrosecond()); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + DateTimeInterface::getTimestamp + DateTimeInterface::format + + + + + diff --git a/reference/datetime/datetimeinterface/gettimestamp.xml b/reference/datetime/datetimeinterface/gettimestamp.xml index 967442b92..3b3dea7b9 100644 --- a/reference/datetime/datetimeinterface/gettimestamp.xml +++ b/reference/datetime/datetimeinterface/gettimestamp.xml @@ -1,5 +1,5 @@ - + @@ -156,6 +156,7 @@ echo $milli, "\n", $micro, "\n"; DateTime::setTimestamp DateTimeImmutable::setTimestamp DateTimeInterface::format + DateTimeInterface::getMicrosecond