[DOC-CVS] [doc-en] master: Improve date format documentation a little bit (#5184)

Author: Lucas Werkmeister (lucaswerkmeister)
Committer: GitHub (web-flow)
Pusher: Girgias
Date: 2026-01-30T10:31:26Z

Commit: https://github.com/php/doc-en/commit/6bbb5b9685d27ac9df744702e06525047a163d4b
Raw diff: https://github.com/php/doc-en/commit/6bbb5b9685d27ac9df744702e06525047a163d4b.diff

Improve date format documentation a little bit (#5184)

Make it a bit more visible yet that DATE_ISO8601 is not compatible with
ISO-8601 (anyone wondering “why ‘like’?” will hopefully see the note
immediately below), and mention the standards that Atom is compatible
with (straight from RFC 4287, section 3.3; I omitted the “Date and Time
Formats” W3C note as it doesn’t seem as prominent as the others) in the
hope of encouraging more people to use it.

Changed paths:
  M  reference/datetime/constants.xml
  M  reference/datetime/datetimeinterface.xml


Diff:

diff --git a/reference/datetime/constants.xml b/reference/datetime/constants.xml
index 3ad77790330c..3a7066449ef2 100644
--- a/reference/datetime/constants.xml
+++ b/reference/datetime/constants.xml
@@ -68,7 +68,7 @@
    </term>
    <listitem>
     <simpara>
-     Atom (example: <literal>2005-08-15T15:52:01+00:00</literal>)
+     Atom (example: <literal>2005-08-15T15:52:01+00:00</literal>); compatible with ISO-8601, RFC 3399, and XML Schema
     </simpara>
    </listitem>
   </varlistentry>
@@ -92,7 +92,7 @@
    </term>
    <listitem>
     <simpara>
-     ISO-8601 (example: <literal>2005-08-15T15:52:01+0000</literal>)
+     ISO-8601-like (example: <literal>2005-08-15T15:52:01+0000</literal>)
     </simpara>
     <note>
      <simpara>
diff --git a/reference/datetime/datetimeinterface.xml b/reference/datetime/datetimeinterface.xml
index 54347e497552..0cd1d238641c 100644
--- a/reference/datetime/datetimeinterface.xml
+++ b/reference/datetime/datetimeinterface.xml
@@ -158,7 +158,7 @@
      <term><constant>DATE_ATOM</constant></term>
      <listitem>
       <simpara>
-       Atom (example: 2005-08-15T15:52:01+00:00)
+       Atom (example: 2005-08-15T15:52:01+00:00); compatible with ISO-8601, RFC 3399, and XML Schema
       </simpara>
      </listitem>
     </varlistentry>
@@ -184,7 +184,7 @@
      <term><constant>DATE_ISO8601</constant></term>
      <listitem>
       <simpara>
-       ISO-8601 (example: 2005-08-15T15:52:01+0000)
+       ISO-8601-like (example: 2005-08-15T15:52:01+0000)
       </simpara>
       <note>
        <simpara>