[doc-en] master: Document the DateObjectError of the DateTime setters and getters (#6072)

From: Date: Fri, 13 Nov 2026 07:47:28 +0000
Subject: [doc-en] master: Document the DateObjectError of the DateTime setters and getters (#6072)
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-23947@lists.php.net to get a copy of this message
Author: Alejandro Borrego (abp002) Committer: GitHub (web-flow) Pusher: lacatoire Date: 2026-11-13T08:47:25+01:00 Commit: https://github.com/php/doc-en/commit/506a93caec897989ad6e1d11a9fcbd53f5d8047b Raw diff: https://github.com/php/doc-en/commit/506a93caec897989ad6e1d11a9fcbd53f5d8047b.diff Document the DateObjectError of the DateTime setters and getters (#6072) Co-authored-by: Alejandro Borrego <210245044+abp002@users.noreply.github.com> Changed paths: M reference/datetime/datetime/setisodate.xml M reference/datetime/datetime/settime.xml M reference/datetime/datetime/settimestamp.xml M reference/datetime/datetime/settimezone.xml M reference/datetime/datetimeimmutable/setisodate.xml M reference/datetime/datetimeimmutable/settime.xml M reference/datetime/datetimeimmutable/settimestamp.xml M reference/datetime/datetimeimmutable/settimezone.xml M reference/datetime/datetimeinterface/getoffset.xml M reference/datetime/datetimeinterface/gettimezone.xml Diff: diff --git a/reference/datetime/datetime/setisodate.xml b/reference/datetime/datetime/setisodate.xml index 094761d70c01..f0f6298f0934 100644 --- a/reference/datetime/datetime/setisodate.xml +++ b/reference/datetime/datetime/setisodate.xml @@ -76,6 +76,39 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <simplelist> diff --git a/reference/datetime/datetime/settime.xml b/reference/datetime/datetime/settime.xml index fd4959192ed6..4a8003e45bac 100644 --- a/reference/datetime/datetime/settime.xml +++ b/reference/datetime/datetime/settime.xml @@ -85,6 +85,15 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <informaltable> @@ -96,6 +105,14 @@ </row> </thead> <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> <row> <entry>8.1.0</entry> <entry>The behaviour with double existing hours (during the fall-back diff --git a/reference/datetime/datetime/settimestamp.xml b/reference/datetime/datetime/settimestamp.xml index 4dd0f5ffa5ba..59d61c0b9a47 100644 --- a/reference/datetime/datetime/settimestamp.xml +++ b/reference/datetime/datetime/settimestamp.xml @@ -57,6 +57,39 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <simplelist> diff --git a/reference/datetime/datetime/settimezone.xml b/reference/datetime/datetime/settimezone.xml index cad6f7e3945d..e8faa4cdd4af 100644 --- a/reference/datetime/datetime/settimezone.xml +++ b/reference/datetime/datetime/settimezone.xml @@ -57,6 +57,39 @@ </simpara> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <example> diff --git a/reference/datetime/datetimeimmutable/setisodate.xml b/reference/datetime/datetimeimmutable/setisodate.xml index 5533bc3128a5..f47dbe8f762a 100644 --- a/reference/datetime/datetimeimmutable/setisodate.xml +++ b/reference/datetime/datetimeimmutable/setisodate.xml @@ -58,6 +58,39 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <example> diff --git a/reference/datetime/datetimeimmutable/settime.xml b/reference/datetime/datetimeimmutable/settime.xml index c0462ba21849..bba6e6085102 100644 --- a/reference/datetime/datetimeimmutable/settime.xml +++ b/reference/datetime/datetimeimmutable/settime.xml @@ -66,6 +66,15 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <informaltable> @@ -77,6 +86,14 @@ </row> </thead> <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> <row> <entry>8.1.0</entry> <entry>The behaviour with double existing hours (during the fall-back diff --git a/reference/datetime/datetimeimmutable/settimestamp.xml b/reference/datetime/datetimeimmutable/settimestamp.xml index 4abbc3201625..aa8cb46484ec 100644 --- a/reference/datetime/datetimeimmutable/settimestamp.xml +++ b/reference/datetime/datetimeimmutable/settimestamp.xml @@ -42,6 +42,39 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <example> diff --git a/reference/datetime/datetimeimmutable/settimezone.xml b/reference/datetime/datetimeimmutable/settimezone.xml index bbe92ee4633a..67a508c4993f 100644 --- a/reference/datetime/datetimeimmutable/settimezone.xml +++ b/reference/datetime/datetimeimmutable/settimezone.xml @@ -42,6 +42,39 @@ </simpara> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <example> diff --git a/reference/datetime/datetimeinterface/getoffset.xml b/reference/datetime/datetimeinterface/getoffset.xml index 2491e26a835a..7da224e86a62 100644 --- a/reference/datetime/datetimeinterface/getoffset.xml +++ b/reference/datetime/datetimeinterface/getoffset.xml @@ -48,6 +48,39 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <example> diff --git a/reference/datetime/datetimeinterface/gettimezone.xml b/reference/datetime/datetimeinterface/gettimezone.xml index f00b38626749..6a5e39d20309 100644 --- a/reference/datetime/datetimeinterface/gettimezone.xml +++ b/reference/datetime/datetimeinterface/gettimezone.xml @@ -49,6 +49,39 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws a <exceptionname>DateObjectError</exceptionname> if the object has + not been correctly initialized, for example when the constructor of a child + class does not call the parent constructor. + </simpara> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.3.0</entry> + <entry> + A <exceptionname>DateObjectError</exceptionname> is now thrown if the + object has not been correctly initialized; previously, an + <exceptionname>Error</exceptionname> was thrown. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <example>

« previous php.doc.cvs (#23947) next »