reference/intl/dateformatter/create.xml
b2332afcd09ceceed83d1e82ad94d7734012bd6f
b2332afcd09ceceed83d1e82ad94d7734012bd6f
...
...
@@ -12,41 +12,38 @@
12
12
<para>
13
13
&style.oop;
14
14
</para>
15
-
<methodsynopsis>
16
-
<modifier>public</modifier>
17
-
<modifier>static</modifier>
18
-
<type>IntlDateFormatter</type><methodname>IntlDateFormatter::create</methodname>
19
-
<methodparam><type>string</type><parameter>locale</parameter></methodparam>
20
-
<methodparam><type>int</type><parameter>datetype</parameter></methodparam>
21
-
<methodparam><type>int</type><parameter>timetype</parameter></methodparam>
22
-
<methodparam choice="opt"><type>mixed</type><parameter>timezone</parameter><initializer>NULL</initializer></methodparam>
23
-
<methodparam choice="opt"><type>mixed</type><parameter>calendar</parameter><initializer>NULL</initializer></methodparam>
24
-
<methodparam choice="opt"><type>string</type><parameter>pattern</parameter><initializer>""</initializer></methodparam>
15
+
<methodsynopsis role="IntlDateFormatter">
16
+
<modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>IntlDateFormatter</type><type>null</type></type><methodname>IntlDateFormatter::create</methodname>
17
+
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>locale</parameter></methodparam>
18
+
<methodparam choice="opt"><type>int</type><parameter>dateType</parameter><initializer>IntlDateFormatter::FULL</initializer></methodparam>
19
+
<methodparam choice="opt"><type>int</type><parameter>timeType</parameter><initializer>IntlDateFormatter::FULL</initializer></methodparam>
20
+
<methodparam choice="opt"><type class="union"><type>IntlTimeZone</type><type>DateTimeZone</type><type>string</type><type>null</type></type><parameter>timezone</parameter><initializer>&null;</initializer></methodparam>
21
+
<methodparam choice="opt"><type class="union"><type>IntlCalendar</type><type>int</type><type>null</type></type><parameter>calendar</parameter><initializer>&null;</initializer></methodparam>
22
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>pattern</parameter><initializer>&null;</initializer></methodparam>
25
23
</methodsynopsis>
26
24
<para>
27
25
&style.oop; (constructor)
28
26
</para>
29
-
<constructorsynopsis>
30
-
<modifier>public</modifier>
31
-
<methodname>IntlDateFormatter::__construct</methodname>
32
-
<methodparam><type>string</type><parameter>locale</parameter></methodparam>
33
-
<methodparam><type>int</type><parameter>datetype</parameter></methodparam>
34
-
<methodparam><type>int</type><parameter>timetype</parameter></methodparam>
35
-
<methodparam choice="opt"><type>mixed</type><parameter>timezone</parameter><initializer>NULL</initializer></methodparam>
36
-
<methodparam choice="opt"><type>mixed</type><parameter>calendar</parameter><initializer>NULL</initializer></methodparam>
37
-
<methodparam choice="opt"><type>string</type><parameter>pattern</parameter><initializer>""</initializer></methodparam>
27
+
<constructorsynopsis role="IntlDateFormatter">
28
+
<modifier>public</modifier> <methodname>IntlDateFormatter::__construct</methodname>
29
+
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>locale</parameter></methodparam>
30
+
<methodparam choice="opt"><type>int</type><parameter>dateType</parameter><initializer>IntlDateFormatter::FULL</initializer></methodparam>
31
+
<methodparam choice="opt"><type>int</type><parameter>timeType</parameter><initializer>IntlDateFormatter::FULL</initializer></methodparam>
32
+
<methodparam choice="opt"><type class="union"><type>IntlTimeZone</type><type>DateTimeZone</type><type>string</type><type>null</type></type><parameter>timezone</parameter><initializer>&null;</initializer></methodparam>
33
+
<methodparam choice="opt"><type class="union"><type>IntlCalendar</type><type>int</type><type>null</type></type><parameter>calendar</parameter><initializer>&null;</initializer></methodparam>
34
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>pattern</parameter><initializer>&null;</initializer></methodparam>
38
35
</constructorsynopsis>
39
36
<para>
40
37
&style.procedural;
41
38
</para>
42
39
<methodsynopsis>
43
-
<type>IntlDateFormatter</type><methodname>datefmt_create</methodname>
44
-
<methodparam><type>string</type><parameter>locale</parameter></methodparam>
45
-
<methodparam><type>int</type><parameter>datetype</parameter></methodparam>
46
-
<methodparam><type>int</type><parameter>timetype</parameter></methodparam>
47
-
<methodparam choice="opt"><type>mixed</type><parameter>timezone</parameter><initializer>NULL</initializer></methodparam>
48
-
<methodparam choice="opt"><type>mixed</type><parameter>calendar</parameter><initializer>NULL</initializer></methodparam>
49
-
<methodparam choice="opt"><type>string</type><parameter>pattern</parameter><initializer>""</initializer></methodparam>
40
+
<type class="union"><type>IntlDateFormatter</type><type>null</type></type><methodname>datefmt_create</methodname>
41
+
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>locale</parameter></methodparam>
42
+
<methodparam choice="opt"><type>int</type><parameter>dateType</parameter><initializer>IntlDateFormatter::FULL</initializer></methodparam>
43
+
<methodparam choice="opt"><type>int</type><parameter>timeType</parameter><initializer>IntlDateFormatter::FULL</initializer></methodparam>
44
+
<methodparam choice="opt"><type class="union"><type>IntlTimeZone</type><type>DateTimeZone</type><type>string</type><type>null</type></type><parameter>timezone</parameter><initializer>&null;</initializer></methodparam>
45
+
<methodparam choice="opt"><type class="union"><type>IntlCalendar</type><type>int</type><type>null</type></type><parameter>calendar</parameter><initializer>&null;</initializer></methodparam>
46
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>pattern</parameter><initializer>&null;</initializer></methodparam>
50
47
</methodsynopsis>
51
48
<para>
52
49
Create a date formatter.
...
...
@@ -68,28 +65,24 @@
68
65
</listitem>
69
66
</varlistentry>
70
67
<varlistentry>
71
-
<term><parameter>datetype</parameter></term>
68
+
<term><parameter>dateType</parameter></term>
72
69
<listitem>
73
70
<para>
74
-
Date type to use (<constant>none</constant>, <constant>short</constant>,
75
-
<constant>medium</constant>, <constant>long</constant>,
76
-
<constant>full</constant>). This is one of the <link
77
-
linkend="intl.intldateformatter-constants">IntlDateFormatter
78
-
constants</link>. It can also be &null;, in which case ICUʼs default
79
-
date type will be used.
71
+
Format of the date determined by one of the
72
+
<link linkend="intl.intldateformatter-constants">IntlDateFormatter
73
+
constants</link>. The default value is
74
+
<constant>IntlDateFormatter::FULL</constant>.
80
75
</para>
81
76
</listitem>
82
77
</varlistentry>
83
78
<varlistentry>
84
-
<term><parameter>timetype</parameter></term>
79
+
<term><parameter>timeType</parameter></term>
85
80
<listitem>
86
81
<para>
87
-
Time type to use (<constant>none</constant>, <constant>short</constant>,
88
-
<constant>medium</constant>, <constant>long</constant>,
89
-
<constant>full</constant>). This is one of the <link
90
-
linkend="intl.intldateformatter-constants">IntlDateFormatter
91
-
constants</link>. It can also be &null;, in which case ICUʼs default
92
-
time type will be used.
82
+
Format of the time determined by one of the
83
+
<link linkend="intl.intldateformatter-constants">IntlDateFormatter
84
+
constants</link>. The default value is
85
+
<constant>IntlDateFormatter::FULL</constant>.
93
86
</para>
94
87
</listitem>
95
88
</varlistentry>
...
...
@@ -146,7 +139,7 @@
146
139
<refsect1 role="returnvalues">
147
140
&reftitle.returnvalues;
148
141
<para>
149
-
The created <classname>IntlDateFormatter</classname> or &false; in case of
142
+
The created <classname>IntlDateFormatter</classname> or &null; in case of
150
143
failure.
151
144
</para>
152
145
</refsect1>
...
...
@@ -164,25 +157,11 @@
164
157
</thead>
165
158
<tbody>
166
159
<row>
167
-
<entry>5.5.0/PECL 3.0.0</entry>
160
+
<entry>8.1.0</entry>
168
161
<entry>
169
162
<para>
170
-
An <classname>IntlCalendar</classname> object is allowed for
171
-
<parameter>calendar</parameter>.
172
-
</para>
173
-
<para>
174
-
Objects of type <classname>IntlTimeZone</classname> and
175
-
<classname>DateTimeZone</classname> are allowed for
176
-
<parameter>timezone</parameter>.
177
-
</para>
178
-
<para>
179
-
Invalid timezone identifiers (including empty strings) are no longer
180
-
allowed for <parameter>timezone</parameter>.
181
-
</para>
182
-
<para>
183
-
If &null; is given for <parameter>timezone</parameter>, the timezone
184
-
identifier given by <function>date_default_timezone_get</function> will
185
-
be used instead of ICUʼs default.
163
+
Parameters <parameter>dateType</parameter> and
164
+
<parameter>timeType</parameter> are now optional.
186
165
</para>
187
166
</entry>
188
167
</row>
...
...
@@ -238,6 +217,26 @@ echo "Second Formatted output with pattern is ".$fmt->format(0);
238
217
]]>
239
218
</programlisting>
240
219
</example>
220
+
<example>
221
+
<title>Example of invalid locale handling</title>
222
+
<programlisting role="php">
223
+
<![CDATA[
224
+
<?php
225
+
try {
226
+
$fmt = new IntlDateFormatter(
227
+
'invalid_locale',
228
+
IntlDateFormatter::FULL,
229
+
IntlDateFormatter::FULL,
230
+
'dunno',
231
+
IntlDateFormatter::GREGORIAN,
232
+
);
233
+
} catch (\Error $e) {
234
+
// ...
235
+
}
236
+
?>
237
+
]]>
238
+
</programlisting>
239
+
</example>
241
240
&example.outputs;
242
241
<screen>
243
242
<![CDATA[
...
...
@@ -261,7 +260,6 @@ Second Formatted output with pattern is 12/31/1969
261
260
</para>
262
261
</refsect1>
263
262
</refentry>
264
-
265
263
<!-- Keep this comment at the end of the file
266
264
Local variables:
267
265
mode: sgml
268
266