Fixed bug #71108: date_create() is NOT an alias for 'new DateTime()'

php · Jun 2, 2022 · fc1c548 · fc1c548
1 parent 7bcd434
commit fc1c548
Show file tree

Hide file tree

Showing 2 changed files with 21 additions and 10 deletions.
diff --git a/reference/datetime/datetime/construct.xml b/reference/datetime/datetime/construct.xml
@@ -3,24 +3,16 @@
 <refentry xml:id="datetime.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateTime::__construct</refname>
-  <refname>date_create</refname>
   <refpurpose>Returns new DateTime object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
-  <para>&style.oop;</para>
   <constructorsynopsis>
    <modifier>public</modifier> <methodname>DateTime::__construct</methodname>
    <methodparam choice="opt"><type>string</type><parameter>datetime</parameter><initializer>"now"</initializer></methodparam>
    <methodparam choice="opt"><type class="union"><type>DateTimeZone</type><type>null</type></type><parameter>timezone</parameter><initializer>&null;</initializer></methodparam>
   </constructorsynopsis>
-  <para>&style.procedural;</para>
-  <methodsynopsis role="procedural">
-   <type class="union"><type>DateTime</type><type>false</type></type><methodname>date_create</methodname>
-   <methodparam choice="opt"><type>string</type><parameter>datetime</parameter><initializer>"now"</initializer></methodparam>
-   <methodparam choice="opt"><type class="union"><type>DateTimeZone</type><type>null</type></type><parameter>timezone</parameter><initializer>&null;</initializer></methodparam>
-  </methodsynopsis>
   <para>
    Like <methodname>DateTimeImmutable::__construct</methodname> but works with
    <classname>DateTime</classname>. Consider using the

diff --git a/reference/datetime/functions/date-create.xml b/reference/datetime/functions/date-create.xml
@@ -3,14 +3,33 @@
 <refentry xml:id="function.date-create" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>date_create</refname>
-  <refpurpose>&Alias; <methodname>DateTime::__construct</methodname></refpurpose>
+  <refpurpose>create a new <classname>DateTime</classname> object</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
+  <methodsynopsis role="procedural">
+   <type class="union"><type>DateTime</type><type>false</type></type><methodname>date_create</methodname>
+   <methodparam choice="opt"><type>string</type><parameter>datetime</parameter><initializer>"now"</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>DateTimeZone</type><type>null</type></type><parameter>timezone</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
   <para>
-   &info.function.alias; <methodname>DateTime::__construct</methodname>
+   This is the procedural version of
+   <methodname>DateTime::__construct</methodname>.
   </para>
+  <para>
+   Unlike the <classname>DateTime</classname> constructor, it will return
+   &false; instead of an exception if the passed in
+   <parameter>datetime</parameter> string is invalid.
+  </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>DateTime::__construct</methodname></member>
+   <member><methodname>DateTimeImmutable::__construct</methodname></member>
+  </simplelist>
  </refsect1>
 
 </refentry>