Skip to content

Commit 13d3db3

Browse files
mumumumumumu
committed
[reference/datetime] sync with en.
1 parent 4013b01 commit 13d3db3

File tree

12 files changed

+219
-140
lines changed

12 files changed

+219
-140
lines changed

‎reference/datetime/constants.xml

Lines changed: 66 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 7913e8b074dfaddff7d8d7446532d8a99f7b9517 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 130701dd4e64351d38da565ab3043a8f795698f8 Maintainer: mumumu Status: ready -->
44
<appendix xml:id="datetime.constants" xmlns="http://docbook.org/ns/docbook">
55
&reftitle.constants;
66
<para>
@@ -59,11 +59,13 @@
5959
</varlistentry>
6060
</variablelist>
6161

62-
63-
<variablelist role="constant_list">
62+
<variablelist>
6463
<title><constant>DATE_<replaceable>*</replaceable></constant> 定数</title>
6564
<varlistentry xml:id="constant.date-atom">
66-
<term><constant>DATE_ATOM</constant></term>
65+
<term>
66+
<constant>DATE_ATOM</constant>
67+
(<type>string</type>)
68+
</term>
6769
<listitem>
6870
<simpara>
6971
Atom (例: <literal>2005-08-15T15:52:01+00:00</literal>)
@@ -72,7 +74,10 @@
7274
</varlistentry>
7375

7476
<varlistentry xml:id="constant.date-cookie">
75-
<term><constant>DATE_COOKIE</constant></term>
77+
<term>
78+
<constant>DATE_COOKIE</constant>
79+
(<type>string</type>)
80+
</term>
7681
<listitem>
7782
<simpara>
7883
HTTP Cookies (例: <literal>Monday, 15-Aug-2005 15:52:01 UTC</literal>)
@@ -81,7 +86,10 @@
8186
</varlistentry>
8287

8388
<varlistentry xml:id="constant.date-iso8601">
84-
<term><constant>DATE_ISO8601</constant></term>
89+
<term>
90+
<constant>DATE_ISO8601</constant>
91+
(<type>string</type>)
92+
</term>
8593
<listitem>
8694
<simpara>
8795
ISO-8601 (例: <literal>2005-08-15T15:52:01+0000</literal>)
@@ -100,7 +108,10 @@
100108
</varlistentry>
101109

102110
<varlistentry xml:id="constant.date-iso8601-expanded">
103-
<term><constant>DATE_ISO8601_EXPANDED</constant></term>
111+
<term>
112+
<constant>DATE_ISO8601_EXPANDED</constant>
113+
(<type>string</type>)
114+
</term>
104115
<listitem>
105116
<simpara>
106117
ISO-8601 拡張形式 (例: <literal>+10191-07-26T08:59:52+01:00</literal>)
@@ -117,7 +128,10 @@
117128
</varlistentry>
118129

119130
<varlistentry xml:id="constant.date-rfc822">
120-
<term><constant>DATE_RFC822</constant></term>
131+
<term>
132+
<constant>DATE_RFC822</constant>
133+
(<type>string</type>)
134+
</term>
121135
<listitem>
122136
<simpara>
123137
RFC 822 (例: <literal>Mon, 15 Aug 05 15:52:01 +0000</literal>)
@@ -126,7 +140,10 @@
126140
</varlistentry>
127141

128142
<varlistentry xml:id="constant.date-rfc850">
129-
<term><constant>DATE_RFC850</constant></term>
143+
<term>
144+
<constant>DATE_RFC850</constant>
145+
(<type>string</type>)
146+
</term>
130147
<listitem>
131148
<simpara>
132149
RFC 850 (例: <literal>Monday, 15-Aug-05 15:52:01 UTC</literal>)
@@ -135,7 +152,10 @@
135152
</varlistentry>
136153

137154
<varlistentry xml:id="constant.date-rfc1036">
138-
<term><constant>DATE_RFC1036</constant></term>
155+
<term>
156+
<constant>DATE_RFC1036</constant>
157+
(<type>string</type>)
158+
</term>
139159
<listitem>
140160
<simpara>
141161
RFC 1036 (例: <literal>Mon, 15 Aug 05 15:52:01 +0000</literal>)
@@ -144,7 +164,10 @@
144164
</varlistentry>
145165

146166
<varlistentry xml:id="constant.date-rfc1123">
147-
<term><constant>DATE_RFC1123</constant></term>
167+
<term>
168+
<constant>DATE_RFC1123</constant>
169+
(<type>string</type>)
170+
</term>
148171
<listitem>
149172
<simpara>
150173
RFC 1123 (例: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>)
@@ -153,17 +176,23 @@
153176
</varlistentry>
154177

155178
<varlistentry xml:id="constant.date-rfc7231">
156-
<term><constant>DATE_RFC7231</constant></term>
157-
<listitem>
158-
<simpara>
159-
RFC 7231 (as of PHP 7.0.19 and 7.1.5)
160-
(例: <literal>Sat, 30 Apr 2016 17:52:13 GMT</literal>)
161-
</simpara>
162-
</listitem>
179+
<term>
180+
<constant>DATE_RFC7231</constant>
181+
(<type>string</type>)
182+
</term>
183+
<listitem>
184+
<simpara>
185+
RFC 7231 (PHP 7.0.19 and 7.1.5 以降で利用可能)
186+
(例: <literal>Sat, 30 Apr 2016 17:52:13 GMT</literal>)
187+
</simpara>
188+
</listitem>
163189
</varlistentry>
164190

165191
<varlistentry xml:id="constant.date-rfc2822">
166-
<term><constant>DATE_RFC2822</constant></term>
192+
<term>
193+
<constant>DATE_RFC2822</constant>
194+
(<type>string</type>)
195+
</term>
167196
<listitem>
168197
<simpara>
169198
RFC 2822 (例: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>)
@@ -172,7 +201,10 @@
172201
</varlistentry>
173202

174203
<varlistentry xml:id="constant.date-rfc3339">
175-
<term><constant>DATE_RFC3339</constant></term>
204+
<term>
205+
<constant>DATE_RFC3339</constant>
206+
(<type>string</type>)
207+
</term>
176208
<listitem>
177209
<simpara>
178210
<constant>DATE_ATOM</constant> と同じです
@@ -181,7 +213,10 @@
181213
</varlistentry>
182214

183215
<varlistentry xml:id="constant.date-rfc3339-extended">
184-
<term><constant>DATE_RFC3339_EXTENDED</constant></term>
216+
<term>
217+
<constant>DATE_RFC3339_EXTENDED</constant>
218+
(<type>string</type>)
219+
</term>
185220
<listitem>
186221
<simpara>
187222
RFC 3339 EXTENDED フォーマット
@@ -191,7 +226,10 @@
191226
</varlistentry>
192227

193228
<varlistentry xml:id="constant.date-rss">
194-
<term><constant>DATE_RSS</constant></term>
229+
<term>
230+
<constant>DATE_RSS</constant>
231+
(<type>string</type>)
232+
</term>
195233
<listitem>
196234
<simpara>
197235
RSS (例: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>).
@@ -201,17 +239,19 @@
201239
</varlistentry>
202240

203241
<varlistentry xml:id="constant.date-w3c">
204-
<term><constant>DATE_W3C</constant></term>
242+
<term>
243+
<constant>DATE_W3C</constant>
244+
(<type>string</type>)
245+
</term>
205246
<listitem>
206247
<simpara>
207-
World Wide Web Consortium (例: <literal>2005-08-15T15:52:01+00:00</literal>).
208-
<constant>DATE_RFC3339</constant> &Alias;.
248+
World Wide Web Consortium (例: <literal>2005-08-15T15:52:01+00:00</literal>)
249+
<constant>DATE_RFC3339</constant> &Alias;
209250
</simpara>
210251
</listitem>
211252
</varlistentry>
212253

213254
</variablelist>
214-
215255
</appendix>
216256
<!-- Keep this comment at the end of the file
217257
Local variables:

‎reference/datetime/dateinterval/createfromdatestring.xml

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: bd1ae73f4a88404c9a3015940c66a85aaeec5889 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 34f483426930c25870b4c5455157e7a759e0053c Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55

66
<refentry xml:id="dateinterval.createfromdatestring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -13,7 +13,7 @@
1313
&reftitle.description;
1414
<para>&style.oop;</para>
1515
<methodsynopsis role="DateInterval">
16-
<modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>DateInterval</type><type>false</type></type><methodname>DateInterval::createFromDateString</methodname>
16+
<modifier>public</modifier> <modifier>static</modifier> <type>DateInterval</type><methodname>DateInterval::createFromDateString</methodname>
1717
<methodparam><type>string</type><parameter>datetime</parameter></methodparam>
1818
</methodsynopsis>
1919
<para>&style.procedural;</para>
@@ -46,7 +46,8 @@
4646
<para>
4747
<literal>P7D</literal> のような ISO-8601
4848
フォーマットの文字列を使うには、
49-
DateInterval のコンストラクタを使わなければいけません。
49+
<methodname>DateInterval::__construct</methodname>
50+
を使わなければいけません。
5051
</para>
5152
</listitem>
5253
</varlistentry>
@@ -57,8 +58,18 @@
5758
<refsect1 role="returnvalues">
5859
&reftitle.returnvalues;
5960
<para>
60-
新しい <classname>DateInterval</classname> のインスタンスを返します。
61-
&return.falseforfailure;
61+
<classname>DateInterval</classname> のインスタンスを返します。
62+
&return.falseforfailure.style.procedural;
63+
</para>
64+
</refsect1>
65+
66+
<refsect1 role="errors">
67+
&reftitle.errors;
68+
<para>
69+
オブジェクト指向のAPIのみ、
70+
無効な日付/時刻の文字列が渡された場合に
71+
<exceptionname>DateMalformedStringException</exceptionname>
72+
がスローされます。
6273
</para>
6374
</refsect1>
6475

@@ -73,6 +84,19 @@
7384
</row>
7485
</thead>
7586
<tbody>
87+
<row>
88+
<entry>8.3.0</entry>
89+
<entry>
90+
無効な文字列が渡された場合、
91+
<methodname>DateInterval::createFromDateString</methodname>
92+
は <exceptionname>DateMalformedStringException</exceptionname>
93+
をスローするようになりました。
94+
これより前のバージョンでは、
95+
警告が発生して <literal>false</literal> を返していました。
96+
<function>date_interval_create_from_date_string</function>
97+
は変更されていません。
98+
</entry>
99+
</row>
76100
<row>
77101
<entry>8.2.0</entry>
78102
<entry>

‎reference/datetime/datetime/modify.xml

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4cd196cb84cb840d2580804e39d3a5dc4682e312 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55

66
<refentry xml:id="datetime.modify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -14,7 +14,7 @@
1414
&reftitle.description;
1515
<para>&style.oop;</para>
1616
<methodsynopsis role="DateTime">
17-
<modifier>public</modifier> <type class="union"><type>DateTime</type><type>false</type></type><methodname>DateTime::modify</methodname>
17+
<modifier>public</modifier> <type>DateTime</type><methodname>DateTime::modify</methodname>
1818
<methodparam><type>string</type><parameter>modifier</parameter></methodparam>
1919
</methodsynopsis>
2020
<para>&style.procedural;</para>
@@ -45,7 +45,8 @@
4545
<refsect1 role="returnvalues">
4646
&reftitle.returnvalues;
4747
<para>
48-
&date.datetime.return.modifiedobjectorfalseforfailure;
48+
成功した場合は <classname>DateTime</classname> を返します。
49+
&return.falseforfailure.style.procedural;
4950
</para>
5051
</refsect1>
5152

@@ -73,10 +74,12 @@
7374
<row>
7475
<entry>8.3.0</entry>
7576
<entry>
76-
無効な文字列が渡された場合、<methodname>DateTime::modify</methodname>
77-
については警告を発生させるのではなく
78-
<exceptionname>DateMalformedStringException</exceptionname>
79-
がスローされるようになりました。
77+
無効な文字列が渡された場合、
78+
<methodname>DateInterval::createFromDateString</methodname>
79+
は <exceptionname>DateMalformedStringException</exceptionname>
80+
をスローするようになりました。
81+
これより前のバージョンでは、
82+
警告が発生して <literal>false</literal> を返していました。
8083
<function>date_modify</function> は変更されていません。
8184
</entry>
8285
</row>

‎reference/datetime/datetime/sub.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d7b51f68698544fb3e0384693809fe2aafa9c69e Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="datetime.sub" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>DateTime::sub</refname>

‎reference/datetime/datetimeimmutable/modify.xml

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: a11c5b53bc132289a0ddcc6d3efee5d97f0027b4 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55

66
<refentry xml:id="datetimeimmutable.modify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -12,7 +12,7 @@
1212
<refsect1 role="description">
1313
&reftitle.description;
1414
<methodsynopsis role="DateTimeImmutable">
15-
<modifier>public</modifier> <type class="union"><type>DateTimeImmutable</type><type>false</type></type><methodname>DateTimeImmutable::modify</methodname>
15+
<modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::modify</methodname>
1616
<methodparam><type>string</type><parameter>modifier</parameter></methodparam>
1717
</methodsynopsis>
1818
<para>
@@ -36,8 +36,8 @@
3636
<refsect1 role="returnvalues">
3737
&reftitle.returnvalues;
3838
<para>
39-
新しく作った DateTimeImmutable オブジェクトを返します。
40-
&return.falseforfailure;
39+
成功時に <classname>DateTimeImmutable</classname> を返します。
40+
&return.falseforfailure.style.procedural;
4141
</para>
4242
</refsect1>
4343

@@ -64,8 +64,12 @@
6464
<row>
6565
<entry>8.3.0</entry>
6666
<entry>
67-
不正な文字列が渡された場合に、警告を発生させるのではなく、
68-
<exceptionname>DateMalformedStringException</exceptionname> がスローされるようになりました。
67+
無効な文字列が渡された場合、
68+
<methodname>DateTimeImmutable::modify</methodname>
69+
は <exceptionname>DateMalformedStringException</exceptionname>
70+
をスローするようになりました。
71+
これより前のバージョンでは、
72+
警告が発生して <literal>false</literal> を返していました。
6973
</entry>
7074
</row>
7175
</tbody>

0 commit comments

Comments
 (0)