php/archived-doc-zh
1
0
Fork 0
mirror of https://github.com/php/doc-zh.git synced 2026-03-24 15:12:20 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
master
archived-doc-zh/reference/datetime/functions/strftime.xml
mowangjuanzi 7c18ff34c6 Update array/datetime/mbstring
2025-11-07 21:24:15 +08:00

706 lines
29 KiB
XML
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: HonestQiao Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>strftime</refname>
<refpurpose>根据区域设置格式化本地时间/日期</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-8-1-0.alternatives;
<simplelist role="alternatives">
<member><function>date</function></member>
<member><methodname>IntlDateFormatter::format</methodname></member>
</simplelist>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>strftime</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
返回用给定的格式字串对给出的 <parameter>timestamp</parameter>
进行格式输出后的字符串。如果没有给出时间戳则用当前的本地时间。月份和星期几以及其它和语言有关的字符串写法和用
<function>setlocale</function> 设定的当前的区域有关。
</para>
<warning>
<para>
可能不是所有的转换标记都被 C 库文件支持，这种情况下 PHP
的 <function>strftime</function>
也不支持。此外，不是所有的平台都支持负的时间戳，因此日期的范围可能限定在不早于
Unix 纪元。这意味着例如
%e, %T，%R 和 %D（可能更多）以及早于
<literal>Jan 1, 1970</literal> 的时间在 Windows，一些 Linux
发行版本，以及其它几个操作系统中无效。对于 Windows
系统，所支持的转换标记可在
<link xlink:href="&url.strftime.win32;"><acronym>MSDN</acronym> 网站</link>找到。
Instead use the
<methodname>IntlDateFormatter::format</methodname> method.
</para>
</warning>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
<table>
<title>
<parameter>format</parameter> 里能够识别的格式字串有以下标记：</title>
<tgroup cols="3">
<thead>
<row>
<entry><parameter>格式</parameter></entry>
<entry>描述</entry>
<entry>返回值示例</entry>
</row>
</thead>
<tbody>
<row>
<entry align="center"><emphasis>日</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%a</literal></entry>
<entry>当前区域星期几的简写</entry>
<entry><literal>Sun</literal> 到 <literal>Sat</literal></entry>
</row>
<row>
<entry><literal>%A</literal></entry>
<entry>当前区域星期几的全称</entry>
<entry><literal>Sunday</literal> 到 <literal>Saturday</literal></entry>
</row>
<row>
<entry><literal>%d</literal></entry>
<entry>月份中的第几天，十进制数字（范围从 01 到 31）</entry>
<entry><literal>01</literal> 到 <literal>31</literal></entry>
</row>
<row>
<entry><literal>%e</literal></entry>
<entry>
月份中的第几天，十进制数字，一位的数字前会加上一个空格（范围从 ' 1' 到 '31'）
在 Windows 上尚未按描述实现。更多信息见下方。
</entry>
<entry><literal> 1</literal> 到 <literal>31</literal></entry>
</row>
<row>
<entry><literal>%j</literal></entry>
<entry>年份中的第几天，带前导零的三位十进制数（范围从 001 到 366）</entry>
<entry><literal>001</literal> 到 <literal>366</literal></entry>
</row>
<row>
<entry><literal>%u</literal></entry>
<entry>符合 ISO-8601 星期几的十进制数表达 [1,7]，1 表示星期一</entry>
<entry><literal>1</literal> (星期一) 到 <literal>7</literal> (星期日)</entry>
</row>
<row>
<entry><literal>%w</literal></entry>
<entry>星期中的第几天，星期天为 0</entry>
<entry><literal>0</literal> (星期天) 到 <literal>6</literal> (星期六)</entry>
</row>
<row>
<entry align="center"><emphasis>周</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%U</literal></entry>
<entry>本年的第几周，从第一周的第一个星期天作为第一天开始</entry>
<entry><literal>13</literal> (for the 13th full week of the year)</entry>
</row>
<row>
<entry><literal>%V</literal></entry>
<entry>
%V - 本年第几周的 ISO-8601:1988 格式，范围从 01 到 53，第
1 周是本年第一个至少还有 4 天的星期，星期一作为每周的第一天。（用
%G 或者 %g 作为指定时间戳相应周数的年份组成。）
</entry>
<entry><literal>01</literal> 到 <literal>53</literal> (where 53
accounts for an overlapping week)</entry>
</row>
<row>
<entry><literal>%W</literal></entry>
<entry>本年的第几周数，从第一周的第一个星期一作为第一天开始</entry>
<entry><literal>46</literal> (for the 46th week of the year beginning
with a Monday)</entry>
</row>
<row>
<entry align="center"><emphasis>月</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%b</literal></entry>
<entry>当前区域月份的简写</entry>
<entry><literal>Jan</literal> 到 <literal>Dec</literal></entry>
</row>
<row>
<entry><literal>%B</literal></entry>
<entry>当前区域月份的全称</entry>
<entry><literal>January</literal> 到 <literal>December</literal></entry>
</row>
<row>
<entry><literal>%h</literal></entry>
<entry>当前区域月份的简写（%b 的别名）</entry>
<entry><literal>Jan</literal> 到 <literal>Dec</literal></entry>
</row>
<row>
<entry><literal>%m</literal></entry>
<entry>两位数的月份</entry>
<entry><literal>01</literal> (是一月份) 到 <literal>12</literal> (是十二月份)</entry>
</row>
<row>
<entry align="center"><emphasis>年</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%C</literal></entry>
<entry>两位数显示世纪（年份除以 100，截成整数）</entry>
<entry><literal>19</literal> 是 20 世纪</entry>
</row>
<row>
<entry><literal>%g</literal></entry>
<entry>
2 位数的年份，符合 ISO-8601:1988 星期数（参见
%V）。和 %V 的格式和值一样，只除了如果 ISO 星期数属于前一年或者后一年，则使用那一年。
</entry>
<entry>比如：2009年1月6日那一周是 <literal>09</literal>。</entry>
</row>
<row>
<entry><literal>%G</literal></entry>
<entry>%g 的完整四位数版本</entry>
<entry>比如：2009年1月3日那一周是 <literal>2008</literal>.</entry>
</row>
<row>
<entry><literal>%y</literal></entry>
<entry>两位数显示年份</entry>
<entry>比如： <literal>09</literal> 是 2009，<literal>79</literal> 是 1979</entry>
</row>
<row>
<entry><literal>%Y</literal></entry>
<entry>四位数显示年份</entry>
<entry>比如： <literal>2038</literal></entry>
</row>
<row>
<entry align="center"><emphasis>时间</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%H</literal></entry>
<entry>以 24 小时格式显示两位小时数</entry>
<entry><literal>00</literal> 到 <literal>23</literal></entry>
</row>
<row>
<entry><literal>%k</literal></entry>
<entry>Hour in 24-hour format, with a space preceding single digits</entry>
<entry><literal> 0</literal> through <literal>23</literal></entry>
</row>
<row>
<entry><literal>%I</literal></entry>
<entry>以 12 小时格式显示两位小时数</entry>
<entry><literal>01</literal> 到 <literal>12</literal></entry>
</row>
<row>
<entry><literal>%l（'L' 的小写）</literal></entry>
<entry>以 12 小时格式显示小时数，单个数字前含空格</entry>
<entry><literal> 1</literal> 到 <literal>12</literal></entry>
</row>
<row>
<entry><literal>%M</literal></entry>
<entry>两位的分钟数</entry>
<entry><literal>00</literal> 到 <literal>59</literal></entry>
</row>
<row>
<entry><literal>%p</literal></entry>
<entry>指定时间的大写 “AM” 或 “PM”</entry>
<entry>比如： 00:31 是 <literal>AM</literal> ，22:23
是<literal>PM</literal>。The exact result depends on the
Operating System, and they can also return lower-case variants, or
variants with dots (such as <literal>a.m.</literal>).</entry>
</row>
<row>
<entry><literal>%P</literal></entry>
<entry>指定时间的小写 “am” 或 “pm”</entry>
<entry>比如：00:31 是 <literal>am</literal> ，22:23
是<literal>pm</literal>。Not supported by all Operating
Systems.</entry>
</row>
<row>
<entry><literal>%r</literal></entry>
<entry>和 "%I:%M:%S %p" 一样</entry>
<entry>比如： 21:34:17 是 <literal>09:34:17 PM</literal></entry>
</row>
<row>
<entry><literal>%R</literal></entry>
<entry>和 "%H:%M" 一样</entry>
<entry>比如： 12:35 AM 是 <literal>00:35</literal>，4:44 PM 是 <literal>16:44</literal></entry>
</row>
<row>
<entry><literal>%S</literal></entry>
<entry>两位数字表示秒</entry>
<entry><literal>00</literal> 到 <literal>59</literal></entry>
</row>
<row>
<entry><literal>%T</literal></entry>
<entry>和 "%H:%M:%S" 一样</entry>
<entry>比如： 09:34:17 PM 是 <literal>21:34:17</literal></entry>
</row>
<row>
<entry><literal>%X</literal></entry>
<entry>当前区域首选的时间表示法，不包括日期</entry>
<entry>例如： <literal>03:59:16</literal> 或 <literal>15:59:16</literal></entry>
</row>
<row>
<entry><literal>%z</literal></entry>
<entry>The time zone offset. Not implemented as described on
Windows. See below for more information.</entry>
<entry>Example: <literal>-0500</literal> for US Eastern Time</entry>
</row>
<row>
<entry><literal>%Z</literal></entry>
<entry>The time zone abbreviation. Not implemented as described on
Windows. See below for more information.</entry>
<entry>Example: <literal>EST</literal> for Eastern Time</entry>
</row>
<row>
<entry align="center"><emphasis>时间和日期戳</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%c</literal></entry>
<entry>当前区域设置首选的日期时间表达</entry>
<entry>比如： 2009 年 2 月 5 日上午 12:45:10 是 <literal>Tue Feb 5 00:45:10 2009</literal></entry>
</row>
<row>
<entry><literal>%D</literal></entry>
<entry>和 "%m/%d/%y" 一样</entry>
<entry>比如： 2009 年 2 月 5 日是 <literal>02/05/09</literal></entry>
</row>
<row>
<entry><literal>%F</literal></entry>
<entry>Same as "%Y-%m-%d" (commonly used in database datestamps)</entry>
<entry>比如：2009 年 2 月 5 日是 <literal>2009-02-05</literal></entry>
</row>
<row>
<entry><literal>%s</literal></entry>
<entry>Unix纪元的时间戳（和 <function>time</function> 函数一样）</entry>
<entry>比如： 1979 年 9 月 10 日上午 8 点 40 分 00 秒是 <literal>305815200</literal></entry>
</row>
<row>
<entry><literal>%x</literal></entry>
<entry>当前区域首选的时间表示法，不包括时间</entry>
<entry>比如： 2009 年 2 月 5 日是 <literal>02/05/09</literal></entry>
</row>
<row>
<entry align="center"><emphasis>其他</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%n</literal></entry>
<entry>换行符("\n")</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%t</literal></entry>
<entry>Tab 字符("\t")</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%%</literal></entry>
<entry>文字上的百分字符("%")</entry>
<entry>---</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<warning>
<simpara>
尽管 ISO 9889:1999（当前的 C 标准）明确指出一周从星期一开始，但是
Sun Solaris 的一周似乎从星期天开始并作为 1。所以 %u 的结果也许不会和手册里描述得一样。
</simpara>
</warning>
<warning>
<para>
<emphasis>仅针对 Windows：</emphasis>
</para>
<para>
这个函数里 <literal>%e</literal>
修饰符修饰符还不能支持 Windows。为了得到这个值可以用
<literal>%#d</literal> 修饰符来代替。下例说明了如何写一个跨平台支持的函数。
</para>
<para>
The <literal>%z</literal> and <literal>%Z</literal> modifiers both
return the time zone name instead of the offset or abbreviation.
</para>
</warning>
<warning>
<simpara>
<emphasis>仅针对 macOS 和 musl：</emphasis>这个函数里 <literal>%P</literal> 修饰符还不能支持 macOS。
</simpara>
</warning>
</listitem>
</varlistentry>
&date.timestamp.description;
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
根据指定的 <parameter>timestamp</parameter> 或未给出 timestamp 是使用当前本地时间，
返回 <parameter>format</parameter> 格式化的字符。
月份、星期名和其他与语言相关的字符串遵守 <function>setlocale</function> 设置的当前区域设置。
The function returns &false; if <parameter>format</parameter> is empty, contains unsupported
conversion specifiers, or if the length of the returned string would be greater than
<literal>4095</literal>.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
<para>
由于输出依赖于 C 库，所以一些转换标记并不被支持。
在 Windows 上，使用未知的转换标记将导致
5 <constant>E_WARNING</constant> 信息，并返回 &false;。
在其他的操作系统上，你可能不能得到任何 <constant>E_WARNING</constant> 信息，
并且可能输出未经转换的转换标记。
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>timestamp</parameter> 现在可为 null。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
如果你的系统里安装了各自的语言环境则下例能够正常运行。
<example>
<title><function>strftime</function> 区域示例</title>
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php
setlocale(LC_TIME, "C");
echo strftime("%A");
setlocale(LC_TIME, "fi_FI");
echo strftime(" in Finnish is %A,");
setlocale(LC_TIME, "fr_FR");
echo strftime(" in French %A and");
setlocale(LC_TIME, "de_DE");
echo strftime(" in German %A.\n");
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>ISO 8601:1988 周数示例</title>
<programlisting role="php">
<![CDATA[
<?php
/* December 2002 / January 2003
ISOWk M Tu W Thu F Sa Su
----- ----------------------------
51 16 17 18 19 20 21 22
52 23 24 25 26 27 28 29
1 30 31 1 2 3 4 5
2 6 7 8 9 10 11 12
3 13 14 15 16 17 18 19 */
// 输出： 12/28/2002 - %V,%G,%Y = 52,2002,2002
echo "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/28/2002")) . "\n";
// 输出： 12/30/2002 - %V,%G,%Y = 1,2003,2002
echo "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/30/2002")) . "\n";
// 输出： 1/3/2003 - %V,%G,%Y = 1,2003,2003
echo "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n";
// 输出： 1/10/2003 - %V,%G,%Y = 2,2003,2003
echo "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n";
/* December 2004 / January 2005
ISOWk M Tu W Thu F Sa Su
----- ----------------------------
51 13 14 15 16 17 18 19
52 20 21 22 23 24 25 26
53 27 28 29 30 31 1 2
1 3 4 5 6 7 8 9
2 10 11 12 13 14 15 16 */
// 输出： 12/23/2004 - %V,%G,%Y = 52,2004,2004
echo "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n";
// 输出： 12/31/2004 - %V,%G,%Y = 53,2004,2004
echo "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n";
// 输出： 1/2/2005 - %V,%G,%Y = 53,2004,2005
echo "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n";
// 输出： 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><literal>%e</literal> 修改器跨平台兼容的示例</title>
<programlisting role="php">
<![CDATA[
<?php
// Jan 1: results in: '%e%1%' (%%, e, %%, %e, %%)
$format = '%%e%%%e%%';
// Check for Windows to find and replace the %e
// modifier correctly
if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN') {
$format = preg_replace('#(?<!%)((?:%%)*)%e#', '</refsect1>%#d', $format);
}
echo strftime($format);
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>显示所有已知和未知的格式</title>
<programlisting role="php">
<![CDATA[
<?php
// Describe the formats
$strftimeFormats = array(
'A' => 'A full textual representation of the day',
'B' => 'Full month name, based on the locale',
'C' => 'Two digit representation of the century (year divided by 100, truncated to an integer)',
'D' => 'Same as "%m/%d/%y"',
'E' => '',
'F' => 'Same as "%Y-%m-%d"',
'G' => 'The full four-digit version of %g',
'H' => 'Two digit representation of the hour in 24-hour format',
'I' => 'Two digit representation of the hour in 12-hour format',
'J' => '',
'K' => '',
'L' => '',
'M' => 'Two digit representation of the minute',
'N' => '',
'O' => '',
'P' => 'lower-case "am" or "pm" based on the given time',
'Q' => '',
'R' => 'Same as "%H:%M"',
'S' => 'Two digit representation of the second',
'T' => 'Same as "%H:%M:%S"',
'U' => 'Week number of the given year, starting with the first Sunday as the first week',
'V' => 'ISO-8601:1988 week number of the given year, starting with the first week of the year with at least 4 weekdays, with Monday being the start of the week',
'W' => 'A numeric representation of the week of the year, starting with the first Monday as the first week',
'X' => 'Preferred time representation based on locale, without the date',
'Y' => 'Four digit representation for the year',
'Z' => 'The time zone offset/abbreviation option NOT given by %z (depends on operating system)',
'a' => 'An abbreviated textual representation of the day',
'b' => 'Abbreviated month name, based on the locale',
'c' => 'Preferred date and time stamp based on local',
'd' => 'Two-digit day of the month (with leading zeros)',
'e' => 'Day of the month, with a space preceding single digits',
'f' => '',
'g' => 'Two digit representation of the year going by ISO-8601:1988 standards (see %V)',
'h' => 'Abbreviated month name, based on the locale (an alias of %b)',
'i' => '',
'j' => 'Day of the year, 3 digits with leading zeros',
'k' => 'Hour in 24-hour format, with a space preceding single digits',
'l' => 'Hour in 12-hour format, with a space preceding single digits',
'm' => 'Two digit representation of the month',
'n' => 'A newline character ("\n")',
'o' => '',
'p' => 'UPPER-CASE "AM" or "PM" based on the given time',
'q' => '',
'r' => 'Same as "%I:%M:%S %p"',
's' => 'Unix Epoch Time timestamp',
't' => 'A Tab character ("\t")',
'u' => 'ISO-8601 numeric representation of the day of the week',
'v' => '',
'w' => 'Numeric representation of the day of the week',
'x' => 'Preferred date representation based on locale, without the time',
'y' => 'Two digit representation of the year',
'z' => 'Either the time zone offset from UTC or the abbreviation (depends on operating system)',
'%' => 'A literal percentage character ("%")',
);
// Results
$strftimeValues = array();
// Evaluate the formats whilst suppressing any errors
foreach ($strftimeFormats as $format => $description) {
if (false !== ($value = @strftime("%{$format}"))) {
$strftimeValues[$format] = $value;
}
}
// Find the longest value
$maxValueLength = 2 + max(array_map('strlen', $strftimeValues));
// Report known formats
foreach ($strftimeValues as $format => $value) {
echo "Known format : '{$format}' = ", str_pad("'{$value}'", $maxValueLength), " ( {$strftimeFormats[$format]} )\n";
}
// Report unknown formats
foreach (array_diff_key($strftimeFormats, $strftimeValues) as $format => $description) {
echo "Unknown format : '{$format}' ", str_pad(' ', $maxValueLength), ($description ? " ( {$description} )" : ''), "\n";
}
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Known format : 'A' = 'Friday' ( A full textual representation of the day )
Known format : 'B' = 'December' ( Full month name, based on the locale )
Known format : 'H' = '11' ( Two digit representation of the hour in 24-hour format )
Known format : 'I' = '11' ( Two digit representation of the hour in 12-hour format )
Known format : 'M' = '24' ( Two digit representation of the minute )
Known format : 'S' = '44' ( Two digit representation of the second )
Known format : 'U' = '48' ( Week number of the given year, starting with the first Sunday as the first week )
Known format : 'W' = '48' ( A numeric representation of the week of the year, starting with the first Monday as the first week )
Known format : 'X' = '11:24:44' ( Preferred time representation based on locale, without the date )
Known format : 'Y' = '2010' ( Four digit representation for the year )
Known format : 'Z' = 'GMT Standard Time' ( The time zone offset/abbreviation option NOT given by %z (depends on operating system) )
Known format : 'a' = 'Fri' ( An abbreviated textual representation of the day )
Known format : 'b' = 'Dec' ( Abbreviated month name, based on the locale )
Known format : 'c' = '12/03/10 11:24:44' ( Preferred date and time stamp based on local )
Known format : 'd' = '03' ( Two-digit day of the month (with leading zeros) )
Known format : 'j' = '337' ( Day of the year, 3 digits with leading zeros )
Known format : 'm' = '12' ( Two digit representation of the month )
Known format : 'p' = 'AM' ( UPPER-CASE "AM" or "PM" based on the given time )
Known format : 'w' = '5' ( Numeric representation of the day of the week )
Known format : 'x' = '12/03/10' ( Preferred date representation based on locale, without the time )
Known format : 'y' = '10' ( Two digit representation of the year )
Known format : 'z' = 'GMT Standard Time' ( Either the time zone offset from UTC or the abbreviation (depends on operating system) )
Known format : '%' = '%' ( A literal percentage character ("%") )
Unknown format : 'C' ( Two digit representation of the century (year divided by 100, truncated to an integer) )
Unknown format : 'D' ( Same as "%m/%d/%y" )
Unknown format : 'E'
Unknown format : 'F' ( Same as "%Y-%m-%d" )
Unknown format : 'G' ( The full four-digit version of %g )
Unknown format : 'J'
Unknown format : 'K'
Unknown format : 'L'
Unknown format : 'N'
Unknown format : 'O'
Unknown format : 'P' ( lower-case "am" or "pm" based on the given time )
Unknown format : 'Q'
Unknown format : 'R' ( Same as "%H:%M" )
Unknown format : 'T' ( Same as "%H:%M:%S" )
Unknown format : 'V' ( ISO-8601:1988 week number of the given year, starting with the first week of the year with at least 4 weekdays, with Monday being the start of the week )
Unknown format : 'e' ( Day of the month, with a space preceding single digits )
Unknown format : 'f'
Unknown format : 'g' ( Two digit representation of the year going by ISO-8601:1988 standards (see %V) )
Unknown format : 'h' ( Abbreviated month name, based on the locale (an alias of %b) )
Unknown format : 'i'
Unknown format : 'k' ( Hour in 24-hour format, with a space preceding single digits )
Unknown format : 'l' ( Hour in 12-hour format, with a space preceding single digits )
Unknown format : 'n' ( A newline character ("\n") )
Unknown format : 'o'
Unknown format : 'q'
Unknown format : 'r' ( Same as "%I:%M:%S %p" )
Unknown format : 's' ( Unix Epoch Time timestamp )
Unknown format : 't' ( A Tab character ("\t") )
Unknown format : 'u' ( ISO-8601 numeric representation of the day of the week )
Unknown format : 'v'
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<simpara>
%G 和 %V，如果数字编号系统未能充分理解，基于 ISO 8601:1988
的星期数可能得出未预期的结果。见上面的 %V 和以下的示例。
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>IntlDateFormatter::format</methodname></member>
<member><methodname>DateTimeInterface::format</methodname></member>
<member><link xlink:href="&url.strftime.format.designer;">Online strftime() format design tool</link></member>
<member><function>setlocale</function></member>
<member><function>mktime</function></member>
<member><function>strptime</function></member>
<member><function>gmstrftime</function></member>
<member><link xlink:href="&spec.strftime;">Open Group specification of <function>strftime</function></link></member>
</simplelist>
</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
-->
Reference in New Issue View Git Blame Copy Permalink