-
Notifications
You must be signed in to change notification settings - Fork 102
/
idate.xml
executable file
·237 lines (225 loc) · 7.06 KB
/
idate.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: dallas Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.idate" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>idate</refname>
<refpurpose>将本地日期/时间格式化为整数</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>int</type><type>false</type></type><methodname>idate</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>
使用明确的 int 类型 <parameter>timestamp</parameter>
或者当前本地时间（如果没有明确时间戳），根据明确的格式化字符串返回格式化后的数字。换句话说，<parameter>timestamp</parameter>
是可选的，默认值是 <function>time</function> 的值。
</para>
<para>
跟 <function>date</function> 不同，<function>idate</function>
只接受一个字符作为 <parameter>format</parameter> 的参数。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
<table>
<title><parameter>format</parameter> 参数字符串仅识别以下字符</title>
<tgroup cols="2">
<thead>
<row>
<entry><parameter>format</parameter> 字符</entry>
<entry>说明</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>B</literal></entry>
<entry>Swatch Beat/互联网时间</entry>
</row>
<row>
<entry><literal>d</literal></entry>
<entry>月份中的第几天</entry>
</row>
<row>
<entry><literal>h</literal></entry>
<entry>小时（12 小时制）</entry>
</row>
<row>
<entry><literal>H</literal></entry>
<entry>小时（24 小时制）</entry>
</row>
<row>
<entry><literal>i</literal></entry>
<entry>分钟</entry>
</row>
<row>
<entry><literal>I</literal>（大写 i）</entry>
<entry>如果启用夏令时则返回 <literal>1</literal>，否则返回 <literal>0</literal></entry>
</row>
<row>
<entry><literal>L</literal>（大写 l）</entry>
<entry>如果是闰年则返回 <literal>1</literal>，否则返回 <literal>0</literal></entry>
</row>
<row>
<entry><literal>m</literal></entry>
<entry>月份的数字</entry>
</row>
<row>
<entry><literal>N</literal></entry>
<entry>ISO-8601 格式的周几（<literal>1</literal> 表示周一到 <literal>7</literal> 表示周日）</entry>
</row>
<row>
<entry><literal>o</literal></entry>
<entry>ISO-8601 格式的年份（4位）</entry>
</row>
<row>
<entry><literal>s</literal></entry>
<entry>秒数</entry>
</row>
<row>
<entry><literal>t</literal></entry>
<entry>本月的总天数</entry>
</row>
<row>
<entry><literal>U</literal></entry>
<entry>自 Unix 纪元（January 1 1970 00:00:00 GMT）起的秒数——这和 <function>time</function> 相同</entry>
</row>
<row>
<entry><literal>w</literal></entry>
<entry>周几（<literal>0</literal> 是周日）</entry>
</row>
<row>
<entry><literal>W</literal></entry>
<entry>ISO-8601 格式的年份中第几个星期，每星期从星期一开始</entry>
</row>
<row>
<entry><literal>y</literal></entry>
<entry>年份（1 或 2 位数字——见下面说明）</entry>
</row>
<row>
<entry><literal>Y</literal></entry>
<entry>年份（4 位数字）</entry>
</row>
<row>
<entry><literal>z</literal></entry>
<entry>年份中的第几天</entry>
</row>
<row>
<entry><literal>Z</literal></entry>
<entry>以秒为单位的时差</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
&date.timestamp.description;
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
成功时返回 <type>int</type>，&return.falseforfailure;。
</para>
<para>
由于 <function>idate</function> 始终返回不以“0”开头的
<type>int</type>，因此 <function>idate</function>
返回的数字可能位数要比期望的小。查看以下示例。
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
</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.2.0</entry>
<entry>
添加 <literal>N</literal>（ISO-8601 格式的周几）和
<literal>o</literal>（ISO-8601 格式的年份）格式字符。
</entry>
</row>
<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>idate</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// 下面以两位数字格式打印年份，但是因为
// 以“0”打头，因此只会打印“4”
echo idate('y', $timestamp);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DateTimeInterface::format</methodname></member>
<member><function>date</function></member>
<member><function>getdate</function></member>
<member><function>time</function></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
-->