Fix #73857: Y2038 issue with getTimestamp and setTimestamp, with alte…

…rnative
php · Nov 17, 2021 · d74736d · d74736d
1 parent d332b5a
commit d74736d
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/reference/datetime/datetime/settimestamp.xml b/reference/datetime/datetime/settimestamp.xml
@@ -35,6 +35,8 @@
     <listitem>
      <para>
       Unix timestamp representing the date.
+      Setting timestamps outside the range of &integer; is possible by using
+      <methodname>DateTime::modify</methodname> with the <literal>@</literal> format.
      </para>
     </listitem>
    </varlistentry>

diff --git a/reference/datetime/datetimeinterface/gettimestamp.xml b/reference/datetime/datetimeinterface/gettimestamp.xml
@@ -46,6 +46,16 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   If the timestamp cannot be represented as &integer;, a <classname>ValueError</classname>
+   is thrown. Prior to PHP 8.0.0, &false; was returned in this case.
+   Still, the timestamp can be retrieved as &string; by using
+   <methodname>DateTimeInterface::format</methodname> with the <literal>U</literal> format.
+  </para>
+ </refsect1>
+
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
   <informaltable>