[doc-en] master: Document the DateObjectError of the DateTime setters and getters (#6072)
| From: | Alejandro Borrego via GitHub | 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>