From 17ece6f8ff69c9c44b01b58f68a00e998a5c5512 Mon Sep 17 00:00:00 2001
From: Kalle Sommer Nielsen <kalle@php.net>
Date: Sat, 23 Oct 2010 05:59:00 +0000
Subject: [PATCH] Fixed bug #45847 strftime() (returns an empty string when
 using the %e conversion specifier)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@304637 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/datetime/functions/strftime.xml | 37 ++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/reference/datetime/functions/strftime.xml b/reference/datetime/functions/strftime.xml
index c81b989dcf..75b99e8d1e 100644
--- a/reference/datetime/functions/strftime.xml
+++ b/reference/datetime/functions/strftime.xml
@@ -73,7 +73,10 @@
           </row>
           <row>
            <entry><literal>%e</literal></entry>
-           <entry>Day of the month, with a space preceding single digits</entry>
+           <entry>
+            Day of the month, with a space preceding single digits. Not 
+            implemented as described on Windows. See below for more information.
+           </entry>
            <entry><literal> 1</literal> to <literal>31</literal></entry>
           </row>
           <row>
@@ -309,6 +312,14 @@
         As a result, %u may not function as described in this manual.
        </simpara>
       </warning>
+      <warning>
+       <simpara>
+        <emphasis>Windows only:</emphasis> The <literal>%e</literal> modifier 
+        is not supported in the Windows implementation of this function. To achieve 
+        this value the <literal>%#d</literal> modifier can be used instead. Below 
+        example will illustrate how to write a cross platform compatible function.
+       </simpara>
+      </warning>
      </listitem>
     </varlistentry>
 
@@ -385,6 +396,8 @@ echo strftime(" in German %A.\n");
 ]]>
     </programlisting>
    </example>
+  </para>
+  <para>
    <example>
     <title>ISO 8601:1988 week number example</title>
     <programlisting role="php">
@@ -434,6 +447,28 @@ echo "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n
 // Outputs: 1/3/2005 - %V,%G,%Y = 1,2005,2005
 echo "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n";
 
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Cross platform compatible example using the %e modifier</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+$format = '%e':
+
+// Check for Windows and only attempt to replace 
+// the %e modifiers if they exists in the format
+if(strtoupper(substr(PHP_OS, 0, 3)) == 'WIN' && strpos($format, '%e') !== false)
+{
+	$format = str_replace('%e', '%#d', $format);
+}
+
+echo strftime($format);
 ?>
 ]]>
     </programlisting>