...

...

@@ -26,17 +26,21 @@

26

26

names and other language-dependent strings respect the current locale set

27

27

with <function>setlocale</function>.

28

28

</para>

29

-

<para>

30

-

Not all conversion specifiers may be supported by your C library, in which

31

-

case they will not be supported by PHP's <function>strftime</function>.

32

-

Additionally, not all platforms support negative timestamps, so your

33

-

date range may be limited to no earlier than the Unix epoch. This means that

34

-

%e, %T, %R and, %D (and possibly others) - as well as dates prior to

35

-

<literal>Jan 1, 1970</literal> - will not work on Windows, some Linux

36

-

distributions, and a few other operating systems. For Windows systems, a

37

-

complete overview of supported conversion specifiers can be found at

38

-

<link xlink:href="&url.strftime.win32;"><acronym>MSDN</acronym></link>.

39

-

</para>

29

+

<warning>

30

+

<para>

31

+

Not all conversion specifiers may be supported by your C library, in which

32

+

case they will not be supported by PHP's <function>strftime</function>.

33

+

Additionally, not all platforms support negative timestamps, so your

34

+

date range may be limited to no earlier than the Unix epoch. This means that

35

+

%e, %T, %R and, %D (and possibly others) - as well as dates prior to

36

+

<literal>Jan 1, 1970</literal> - will not work on Windows, some Linux

37

+

distributions, and a few other operating systems. For Windows systems, a

38

+

complete overview of supported conversion specifiers can be found at

39

+

<link xlink:href="&url.strftime.win32;"><acronym>MSDN</acronym></link>.

40

+

Instead use the

41

+

<methodname>IntlDateFormatter::format</methodname> method.

42

+

</para>

43

+

</warning>

40

44

</refsect1>

41

45

42

46

<refsect1 role="parameters">

...

...

@@ -216,12 +220,17 @@

216

220

<row>

217

221

<entry><literal>%p</literal></entry>

218

222

<entry>UPPER-CASE 'AM' or 'PM' based on the given time</entry>

219

-

<entry>Example: <literal>AM</literal> for 00:31, <literal>PM</literal> for 22:23</entry>

223

+

<entry>Example: <literal>AM</literal> for 00:31,

224

+

<literal>PM</literal> for 22:23. The exact result depends on the

225

+

Operating System, and they can also return lower-case variants, or

226

+

variants with dots (such as <literal>a.m.</literal>).</entry>

220

227

</row>

221

228

<row>

222

229

<entry><literal>%P</literal></entry>

223

230

<entry>lower-case 'am' or 'pm' based on the given time</entry>

224

-

<entry>Example: <literal>am</literal> for 00:31, <literal>pm</literal> for 22:23</entry>

231

+

<entry>Example: <literal>am</literal> for 00:31,

232

+

<literal>pm</literal> for 22:23. Not supported by all Operating

233

+

Systems.</entry>

225

234

</row>

226

235

<row>

227

236

<entry><literal>%r</literal></entry>

...

...

@@ -669,6 +678,8 @@ Unknown format : 'v'

669

678

&reftitle.seealso;

670

679

<para>

671

680

<simplelist>

681

+

<member><methodname>IntlDateFormatter::format</methodname></member>

682

+

<member><methodname>DateTimeInterface::format</methodname></member>

672

683

<member><link xlink:href="&url.strftime.format.designer;">Online strftime() format design tool</link></member>

673

684

<member><function>setlocale</function></member>

674

685

<member><function>mktime</function></member>

675

686