Skip to content

[Sync EN] Add new 8.4 DateTime functions #359

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
Open

[Sync EN] Add new 8.4 DateTime functions #359

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 96 additions & 0 deletions reference/datetime/datetime/createfromtimestamp.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: lacatoire Status: ready -->
<refentry xml:id="datetime.createfromtimestamp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTime::createFromTimestamp</refname>
<refpurpose>Erzeugt eine Instanz aus einem Unix-Zeitstempel</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DateTime">
<modifier>public</modifier> <modifier>static</modifier> <type>static</type><methodname>DateTime::createFromTimestamp</methodname>
<methodparam><type class="union"><type>int</type><type>float</type></type><parameter>timestamp</parameter></methodparam>
</methodsynopsis>

<simpara>
Erzeugt eine Instanz aus einem Unix-Zeitstempel.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;

<variablelist>
<varlistentry>
<term><parameter>timestamp</parameter></term>
<listitem>
<simpara>
Ein Unix-Zeitstempel, der das Datum angibt.
Es wird auch ein &float;-Wert akzeptiert, der eine Genauigkeit im
Mikrosekundenbereich ermöglicht.
</simpara>
</listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Gibt eine neue <classname>DateTime</classname>-Instanz zurück.
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Wenn der <parameter>timestamp</parameter> außerhalb des Bereichs
[<constant>PHP_INT_MIN</constant>, <constant>PHP_INT_MAX</constant>] liegt,
wird ein <exceptionname>DateRangeError</exceptionname> geworfen.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example xml:id="datetime.createfromtimestamp.example.basic">
<title><methodname>DateTime::createFromTimestamp</methodname>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$date = DateTime::createFromTimestamp(123.456789);
echo $date->format('Y-m-d H:i:s.u');
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
1970-01-01 00:02:03.456789
]]>
</screen>
</example>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
110 changes: 110 additions & 0 deletions reference/datetime/datetime/setmicrosecond.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: lacatoire Status: ready -->
<refentry xml:id="datetime.setmicrosecond" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTime::setMicrosecond</refname>
<refpurpose>Setzt den Mikrosekundenanteil der Zeit</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DateTime">
<modifier>public</modifier> <type>static</type><methodname>DateTime::setMicrosecond</methodname>
<methodparam><type>int</type><parameter>microsecond</parameter></methodparam>
</methodsynopsis>

<simpara>
Setzt den Mikrosekundenanteil der Zeit.
</simpara>
<simpara>
Wie <methodname>DateTimeImmutable::setMicrosecond</methodname>, arbeitet
aber mit <classname>DateTime</classname>.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;

<variablelist>
<varlistentry>
<term><parameter>microsecond</parameter></term>
<listitem>
<simpara>
Der zu setzende Mikrosekundenwert (<literal>0</literal> bis
<literal>999999</literal>).
</simpara>
</listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
&date.datetime.return.modifiedobject;
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Wenn der <parameter>microsecond</parameter> außerhalb des Bereichs
[<literal>0</literal>, <literal>999999</literal>] liegt, wird ein
<exceptionname>DateRangeError</exceptionname> geworfen.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example xml:id="datetime.setmicrosecond.example.basic">
<title><methodname>DateTime::setMicrosecond</methodname>-Beispiel</title>

<programlisting role="php">
<![CDATA[
<?php
$date = DateTime::createFromTimestamp(123.456789);
echo $date->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;
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
1970-01-01 00:02:03.456789
1970-01-01 00:02:03.987654
]]>
</screen>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>DateTimeInterface::getMicrosecond</methodname></member>
</simplelist>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
4 changes: 2 additions & 2 deletions reference/datetime/datetime/settimestamp.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: cmb Status: ready -->
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: cmb Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: d74736d8039bbb4fed0c5254de9be5a27d71ebec Reviewer: samesch -->
<!-- CREDITS: Stefan Schenke -->
Expand Down Expand Up @@ -66,6 +65,7 @@
&reftitle.seealso;
<simplelist>
<member><function>DateTimeImmutable::setTimestamp</function></member>
<member><function>DateTime::setMicrosecond</function></member>
</simplelist>
</refsect1>

Expand Down
4 changes: 2 additions & 2 deletions reference/datetime/datetimeimmutable/add.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 42d5fb01e01e9ab1fdb47612833dd13d9003df6a Maintainer: samesch Status: ready -->
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimeimmutable.add" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -13,7 +13,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DateTimeImmutable">
<modifier role="attribute">#[\NoDiscard]</modifier>
<modifier role="attribute">#[\NoDiscard(message: "as DateTimeImmutable::add() does not modify the object itself")]</modifier>
<modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::add</methodname>
<methodparam><type>DateInterval</type><parameter>interval</parameter></methodparam>
</methodsynopsis>
Expand Down
96 changes: 96 additions & 0 deletions reference/datetime/datetimeimmutable/createfromtimestamp.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: lacatoire Status: ready -->
<refentry xml:id="datetimeimmutable.createfromtimestamp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTimeImmutable::createFromTimestamp</refname>
<refpurpose>Erzeugt eine Instanz aus einem Unix-Zeitstempel</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DateTimeImmutable">
<modifier>public</modifier> <modifier>static</modifier> <type>static</type><methodname>DateTimeImmutable::createFromTimestamp</methodname>
<methodparam><type class="union"><type>int</type><type>float</type></type><parameter>timestamp</parameter></methodparam>
</methodsynopsis>

<simpara>
Erzeugt eine Instanz aus einem Unix-Zeitstempel.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;

<variablelist>
<varlistentry>
<term><parameter>timestamp</parameter></term>
<listitem>
<simpara>
Ein Unix-Zeitstempel, der das Datum angibt.
Es wird auch ein &float;-Wert akzeptiert, der eine Genauigkeit im
Mikrosekundenbereich ermöglicht.
</simpara>
</listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Gibt eine neue <classname>DateTimeImmutable</classname>-Instanz zurück.
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Wenn der <parameter>timestamp</parameter> außerhalb des Bereichs
[<constant>PHP_INT_MIN</constant>, <constant>PHP_INT_MAX</constant>] liegt,
wird ein <exceptionname>DateRangeError</exceptionname> geworfen.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example xml:id="datetimeimmutable.createfromtimestamp.example.basic">
<title><methodname>DateTimeImmutable::createFromTimestamp</methodname>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$date = DateTimeImmutable::createFromTimestamp(123.456789);
echo $date->format('Y-m-d H:i:s.u');
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
1970-01-01 00:02:03.456789
]]>
</screen>
</example>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
11 changes: 9 additions & 2 deletions reference/datetime/datetimeimmutable/modify.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: samesch Status: ready -->
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimeimmutable.modify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -10,7 +10,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DateTimeImmutable">
<modifier role="attribute">#[\NoDiscard]</modifier>
<modifier role="attribute">#[\NoDiscard(message: "as DateTimeImmutable::modify() does not modify the object itself")]</modifier>
<modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::modify</methodname>
<methodparam><type>string</type><parameter>modifier</parameter></methodparam>
</methodsynopsis>
Expand Down Expand Up @@ -61,6 +61,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Hat nun einen vorläufigen Rückgabetyp von <type>DateTimeImmutable</type>.
Zuvor war es <type class="union"><type>DateTimeImmutable</type><type>false</type></type>.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
Expand Down
4 changes: 2 additions & 2 deletions reference/datetime/datetimeimmutable/setdate.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: samesch Status: ready -->
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimeimmutable.setdate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -10,7 +10,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DateTimeImmutable">
<modifier role="attribute">#[\NoDiscard]</modifier>
<modifier role="attribute">#[\NoDiscard(message: "as DateTimeImmutable::setDate() does not modify the object itself")]</modifier>
<modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::setDate</methodname>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
Expand Down
4 changes: 2 additions & 2 deletions reference/datetime/datetimeimmutable/setisodate.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: samesch Status: ready -->
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimeimmutable.setisodate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -10,7 +10,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="DateTimeImmutable">
<modifier role="attribute">#[\NoDiscard]</modifier>
<modifier role="attribute">#[\NoDiscard(message: "as DateTimeImmutable::setISODate() does not modify the object itself")]</modifier>
<modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::setISODate</methodname>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam><type>int</type><parameter>week</parameter></methodparam>
Expand Down
Loading
Loading