From e493e7563b59de4cd3f55573c8d1e0916a71eaef Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gustavo=20Andr=C3=A9=20dos=20Santos=20Lopes?= Date: Sun, 16 Jun 2013 14:39:08 +0000 Subject: [PATCH] Update doc for IntlDateFormatter::create(). git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@330518 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/intl/dateformatter/create.xml | 114 ++++++++++++++++++------ 1 file changed, 89 insertions(+), 25 deletions(-) diff --git a/reference/intl/dateformatter/create.xml b/reference/intl/dateformatter/create.xml index cb8c2ac4e1..9dd71c61a1 100644 --- a/reference/intl/dateformatter/create.xml +++ b/reference/intl/dateformatter/create.xml @@ -18,9 +18,9 @@ stringlocale intdatetype inttimetype - stringtimezone - intcalendar - stringpattern + mixedtimezoneNULL + mixedcalendarNULL + stringpattern'' &style.oop; (constructor) @@ -30,9 +30,9 @@ stringlocale intdatetype inttimetype - stringtimezone - intcalendar - stringpattern + mixedtimezoneNULL + mixedcalendarNULL + stringpattern'' &style.procedural; @@ -42,12 +42,12 @@ stringlocale intdatetype inttimetype - stringtimezone - intcalendar - stringpattern + mixedtimezoneNULL + mixedcalendarNULL + stringpattern'' - Create a date formatter + Create a date formatter. @@ -59,7 +59,9 @@ locale - Locale to use when formatting or parsing. + Locale to use when formatting or parsing or &null; to use the value + specified in the ini setting intl.default_locale. @@ -67,11 +69,12 @@ datetype - Date type to use (none, - short, medium, - long, full). - This is one of the - IntlDateFormatter constants. + Date type to use (none, short, + medium, long, + full). This is one of the IntlDateFormatter + constants. It can also be &null;, in which case ICUʼs default + date type will be used. @@ -79,11 +82,12 @@ timetype - Time type to use (none, - short, medium, - long, full). - This is one of the - IntlDateFormatter constants. + Time type to use (none, short, + medium, long, + full). This is one of the IntlDateFormatter + constants. It can also be &null;, in which case ICUʼs default + time type will be used. @@ -91,7 +95,16 @@ timezone - Time zone ID, default is system default. + Time zone ID. The default (and the one used if &null; is given) is the + one returned by date_default_timezone_get or, if + applicable, that of the IntlCalendar object passed + for the calendar parameter. This ID must be a + valid identifier on ICUʼs database or an ID representing an + explicit offset, such as GMT-05:30. + + + This can also be an IntlTimeZone or a + DateTimeZone object. @@ -99,9 +112,17 @@ calendar - Calendar to use for formatting or parsing; default is Gregorian. - This is one of the - IntlDateFormatter calendar constants. + Calendar to use for formatting or parsing. The default value is &null;, + which corresponds to IntlDateFormatter::GREGORIAN. + This can either be one of the + IntlDateFormatter + calendar constants or an IntlCalendar. Any + IntlCalendar object passed will be clone; it will + not be changed by the IntlDateFormatter. This will + determine the calendar type used (gregorian, islamic, persian, etc.) and, + if &null; is given for the timezone parameter, + also the timezone used. @@ -123,6 +144,49 @@ &reftitle.returnvalues; + The created IntlDateFormatter or &false; in case of + failure. + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 5.5.0/PECL 3.0.0 + + + An IntlCalendar object is allowed for + calendar. + + + Objects of type IntlTimeZone and + DateTimeZone are allowed for + timezone. + + + Invalid timezone identifiers (including empty strings) are no longer + allowed for timezone. + + + If &null; is given for timezone, the timezone + identifier given by date_default_timezone_get will + be used instead of ICUʼs default. + + + + + +