From 6d19a7d71d68eb6f9bb7be08b796e7994fb24dfb Mon Sep 17 00:00:00 2001
From: Mathieu Rochette <mathieu@rochette.cc>
Date: Wed, 14 Jan 2026 14:44:46 +0100
Subject: [PATCH 1/2] Document createFromTimestamp(0 for DateTime and
 DateTimeImmutable

---
 .../datetime/datetime/createfromtimestamp.xml | 75 +++++++++++++++++++
 .../datetimeimmutable/createfromtimestamp.xml | 75 +++++++++++++++++++
 reference/datetime/versions.xml               |  2 +
 3 files changed, 152 insertions(+)
 create mode 100644 reference/datetime/datetime/createfromtimestamp.xml
 create mode 100644 reference/datetime/datetimeimmutable/createfromtimestamp.xml

diff --git a/reference/datetime/datetime/createfromtimestamp.xml b/reference/datetime/datetime/createfromtimestamp.xml
new file mode 100644
index 000000000000..b2770046ce3d
--- /dev/null
+++ b/reference/datetime/datetime/createfromtimestamp.xml
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<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>Returns a new DateTime instance encapsulating the given timestamp</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>int|float</type><parameter>timestamp</parameter></methodparam>
+  </methodsynopsis>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>timestamp</parameter></term>
+     <listitem>
+      <para>
+       A Unix timestamp.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns a new <classname>DateTime</classname> instance.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Creating a date time object from a timestamp</title>
+    <programlisting role="php" annotations="non-interactive">
+<![CDATA[
+<?php
+$dt = DateTime::createFromTimestamp( 1403261100 );
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </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
+-->
diff --git a/reference/datetime/datetimeimmutable/createfromtimestamp.xml b/reference/datetime/datetimeimmutable/createfromtimestamp.xml
new file mode 100644
index 000000000000..36844cc64e91
--- /dev/null
+++ b/reference/datetime/datetimeimmutable/createfromtimestamp.xml
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<refentry xml:id="datetimeimmutble.createfromtimestamp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>DateTimeImmutable::createFromTimestamp</refname>
+  <refpurpose>Returns a new DateTimeImmutable instance encapsulating the given timestamp</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>int|float</type><parameter>timestamp</parameter></methodparam>
+  </methodsynopsis>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>timestamp</parameter></term>
+     <listitem>
+      <para>
+       A Unix timestamp.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns a new <classname>DateTimeImmutable</classname> instance.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Creating a date time object from a timestamp</title>
+    <programlisting role="php" annotations="non-interactive">
+<![CDATA[
+<?php
+$dt = DateTimeImmutable::createFromTimestamp( 1403261100 );
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </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
+-->
diff --git a/reference/datetime/versions.xml b/reference/datetime/versions.xml
index 9e8d253b7096..18f3451c7ef7 100644
--- a/reference/datetime/versions.xml
+++ b/reference/datetime/versions.xml
@@ -15,6 +15,7 @@
  <function name="datetime::createfromformat" from="PHP 5 &gt;= 5.3.0, PHP 7, PHP 8"/>
  <function name="datetime::createfromimmutable" from="PHP 7 &gt;= 7.3.0, PHP 8"/>
  <function name="datetime::createfrominterface" from="PHP 8"/>
+ <function name="datetime::createfromtimestamp" from="PHP 8 &gt;= 8.4.0"/>
  <function name="datetime::diff" from="PHP 5 &gt;= 5.3.0, PHP 7, PHP 8"/>
  <function name="datetime::format" from="PHP 5 &gt;= 5.2.1, PHP 7, PHP 8"/>
  <function name="datetime::getlasterrors" from="PHP 5 &gt;= 5.3.0, PHP 7, PHP 8"/>
@@ -48,6 +49,7 @@
  <function name="datetimeimmutable::createfromformat" from="PHP 5 &gt;= 5.5.0, PHP 7, PHP 8"/>
  <function name="datetimeimmutable::createfrommutable" from="PHP 5 &gt;= 5.6.0, PHP 7, PHP 8"/>
  <function name="datetimeimmutable::createfrominterface" from="PHP 8"/>
+ <function name="datetimeimmutable::createfromtimestamp" from="PHP 8 &gt;= 8.4.0"/>
  <function name="datetimeimmutable::diff" from="PHP 5 &gt;= 5.5.0, PHP 7, PHP 8"/>
  <function name="datetimeimmutable::format" from="PHP 5 &gt;= 5.5.0, PHP 7, PHP 8"/>
  <function name="datetimeimmutable::getlasterrors" from="PHP 5 &gt;= 5.5.0, PHP 7, PHP 8"/>

From c8ef88df838d2b0ab90925db590af1a7adf5d8fd Mon Sep 17 00:00:00 2001
From: Mathieu Rochette <mathieu@rochette.cc>
Date: Wed, 14 Jan 2026 23:32:32 +0100
Subject: [PATCH 2/2] Apply suggestions from code review

Co-authored-by: Gina Peter Banyard <girgias@php.net>
---
 .../datetime/datetime/createfromtimestamp.xml | 38 +++++++++----------
 .../datetimeimmutable/createfromtimestamp.xml | 38 +++++++++----------
 2 files changed, 34 insertions(+), 42 deletions(-)

diff --git a/reference/datetime/datetime/createfromtimestamp.xml b/reference/datetime/datetime/createfromtimestamp.xml
index b2770046ce3d..aceaaafe9bd9 100644
--- a/reference/datetime/datetime/createfromtimestamp.xml
+++ b/reference/datetime/datetime/createfromtimestamp.xml
@@ -16,40 +16,36 @@
 
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter>timestamp</parameter></term>
-     <listitem>
-      <para>
-       A Unix timestamp.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   <varlistentry>
+    <term><parameter>timestamp</parameter></term>
+    <listitem>
+     <simpara>
+      A Unix timestamp.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
+  <simpara>
    Returns a new <classname>DateTime</classname> instance.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
-  <para>
-   <example>
-    <title>Creating a date time object from a timestamp</title>
-    <programlisting role="php" annotations="non-interactive">
+  <example>
+   <title>Creating a date time object from a timestamp</title>
+   <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 $dt = DateTime::createFromTimestamp( 1403261100 );
 ]]>
-    </programlisting>
-   </example>
-  </para>
+   </programlisting>
+  </example>
  </refsect1>
 
 </refentry>
diff --git a/reference/datetime/datetimeimmutable/createfromtimestamp.xml b/reference/datetime/datetimeimmutable/createfromtimestamp.xml
index 36844cc64e91..604ab7768189 100644
--- a/reference/datetime/datetimeimmutable/createfromtimestamp.xml
+++ b/reference/datetime/datetimeimmutable/createfromtimestamp.xml
@@ -16,40 +16,36 @@
 
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter>timestamp</parameter></term>
-     <listitem>
-      <para>
-       A Unix timestamp.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   <varlistentry>
+    <term><parameter>timestamp</parameter></term>
+    <listitem>
+     <simpara>
+      A Unix timestamp.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
+  <simpara>
    Returns a new <classname>DateTimeImmutable</classname> instance.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
-  <para>
-   <example>
-    <title>Creating a date time object from a timestamp</title>
-    <programlisting role="php" annotations="non-interactive">
+  <example>
+   <title>Creating a date time object from a timestamp</title>
+   <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 $dt = DateTimeImmutable::createFromTimestamp( 1403261100 );
 ]]>
-    </programlisting>
-   </example>
-  </para>
+   </programlisting>
+  </example>
  </refsect1>
 
 </refentry>