(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
IntlDateFormatter::create -- datefmt_create -- IntlDateFormatter::__construct — Создаёт средство форматирования даты
Объектно-ориентированный стиль
$locale,$dateType = IntlDateFormatter::FULL ,$timeType = IntlDateFormatter::FULL ,$timezone = null ,$calendar = null ,$pattern = null Объектно-ориентированный стиль (конструктор)
$locale,$dateType = IntlDateFormatter::FULL ,$timeType = IntlDateFormatter::FULL ,$timezone = null ,$calendar = null ,$pattern = null Процедурный стиль
$locale,$dateType = IntlDateFormatter::FULL ,$timeType = IntlDateFormatter::FULL ,$timezone = null ,$calendar = null ,$pattern = ""Создаёт средство форматирования даты.
locale
Языковой стандарт, который будет использован для форматирования или синтаксического анализа,
или null для выбора значения, заданного в ini-настройке
intl.default_locale.
dateType
Формат даты, который был определён одной
из констант IntlDateFormatter.
Значение по умолчанию
IntlDateFormatter::FULL .
timeType
Формат времени, который был определён одной
из констант IntlDateFormatter.
Значение по умолчанию
IntlDateFormatter::FULL .
timezone
Идентификатор часового пояса. По умолчанию (и тот, который используется, если указан null ) — это тот,
который возвращается date_default_timezone_get() или, если применимо,
объект IntlCalendar , указанный в параметре calendar.
Этот идентификатор должен быть корректным идентификатором в базе данных ICU или идентификатором,
представляющим явное смещение, например, GMT-05:30.
Также может быть объект IntlTimeZone или DateTimeZone .
calendar
Календарь для форматирования или анализа. Значение по умолчанию — null ,
что соответствует IntlDateFormatter::GREGORIAN .
Может быть одна из констант IntlDateFormatter
или объект IntlCalendar .
Любой переданный объект IntlCalendar будет клонирован; он не будет изменён IntlDateFormatter .
Это определит используемый тип календаря (григорианский, исламский, персидский и т.д.) и, если в параметре timezone
указано значение null , также определит используемый часовой пояс.
patternНеобязательный шаблон для использования при форматировании или анализе. Возможные шаблоны задокументированы по адресу » https://unicode-org.github.io/icu/userguide/format_parse/datetime/.
Метод возвращает созданный объект IntlDateFormatter или null в случае возникновения ошибки.
Если значение параметра locale некорректно,
выбрасывается ошибка ValueError .
| Версия | Описание |
|---|---|
| 8.4.0 |
Теперь если значение параметра locale некорректно,
выбрасывается ошибка ValueError .
|
| 8.1.0 |
Теперь параметры |
Пример #1 Пример использования функции datefmt_create()
<?php
$fmt = datefmt_create( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles', IntlDateFormatter::GREGORIAN );
echo "First Formatted output is ".datefmt_format( $fmt , 0);
$fmt = datefmt_create( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo "Second Formatted output is ".datefmt_format( $fmt , 0);
$fmt = datefmt_create( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN ,"MM/dd/yyyy");
echo "First Formatted output with pattern is ".datefmt_format( $fmt , 0);
$fmt = datefmt_create( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN ,"MM/dd/yyyy");
echo "Second Formatted output with pattern is ".datefmt_format( $fmt , 0);
?>Пример #2 Пример использования в объектно-ориентированном стиле
<?php
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo "Первый форматированный вывод: ".$fmt->format(0);
$fmt = new IntlDateFormatter( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN );
echo "Второй форматированный вывод: ".$fmt->format(0);
$fmt = new IntlDateFormatter( "en_US" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN ,"MM/dd/yyyy");
echo "Первый форматированный вывод с шаблоном: ".$fmt->format(0);
$fmt = new IntlDateFormatter( "de-DE" ,IntlDateFormatter::FULL, IntlDateFormatter::FULL,
'America/Los_Angeles',IntlDateFormatter::GREGORIAN , "MM/dd/yyyy");
echo "Второй форматированный вывод с шаблоном: ".$fmt->format(0);
?>Пример #3 Пример обработки неверного значения языкового стандарта
<?php
try {
$fmt = new IntlDateFormatter(
'invalid_locale',
IntlDateFormatter::FULL,
IntlDateFormatter::FULL,
'dunno',
IntlDateFormatter::GREGORIAN,
);
} catch (\Error $e) {
// ...
}
?>Результат выполнения приведённого примера:
Первый форматированный вывод: Wednesday, December 31, 1969 4:00:00 PM PT Второй форматированный вывод: Mittwoch, 31. Dezember 1969 16:00 Uhr GMT-08:00 Первый форматированный вывод с шаблоном: 12/31/1969 Второй форматированный вывод с шаблоном: 12/31/1969
It should be noted that the locale string passed into IntlDateFormatter's constructor supports UCA keywords. So you can, for example, do things like this to output the year as a Japanese era year:
<?php
$now = new DateTime(); //DateTime is a core PHP class as of version 5.2.0
$formatter = new IntlDateFormatter('ja_JP', IntlDateFormatter::FULL,
IntlDateFormatter::FULL, 'Asia/Tokyo', IntlDateFormatter::GREGORIAN);
echo 'It is now: "' . $formatter->format($now) . '" in Tokyo' . "\n";
//above gives [It is now: "2011年8月19日金曜日 23時32分27秒JST" in Tokyo]
$formatter = new IntlDateFormatter('ja_JP@calendar=japanese', IntlDateFormatter::FULL,
IntlDateFormatter::FULL, 'Asia/Tokyo', IntlDateFormatter::TRADITIONAL);
echo 'It is now: "' . $formatter->format($now) . '" in Tokyo' . "\n";
//above gives [It is now: "平成23年8月19日金曜日 23時32分27秒JST" in Tokyo]
?>The documentation says that $datetype and $timetype can also be NULL, in which case ICUʼs default date type or time type will be used.
But when declare (strict_types=1); is also set, Intl fails to create the IntlDateFormatter class, and it returns an error "datefmt_create: unable to parse input parameters".Documentation says "timezone: Time zone ID, default is system default."
The "system default" really means only the "TZ" environment variable on Unix/Linux systems. It does not mean PHP ini setting or value set via date_default_timezone_set() or the OS default time zone in file "/etc/timezone".The $locale can although contain the information about the calendar
<?php
//...
$traditionalFormatter = new IntlDateFormatter(
$locale.'@calendar='.$calendar,
IntlDateFormatter::SHORT,
IntlDateFormatter::SHORT,
'Europe/Berlin',
IntlDateFormatter::TRADITIONAL,
'yyyy/MM/dd HH:mm:ss' // ICU-datetime-format
);
//..
?>
To get the allowed values for $calendar, use the following code:
<?php
$bundle=new ResourceBundle('','ICUDATA');
$cnames=[];
$calendars=$bundle->get('calendar');
foreach($calendars as $n=>$v){
$cnames[]=$n;
}
echo (print_r($cnames,true));
?>
The result is:
Array
(
[0] => buddhist
[1] => chinese
[2] => coptic
[3] => dangi
[4] => default
[5] => ethiopic
[6] => ethiopic-amete-alem
[7] => gregorian
[8] => hebrew
[9] => indian
[10] => islamic
[11] => islamic-civil
[12] => japanese
[13] => persian
[14] => roc
)Just to be clear, to use any non-gregorian calendar:
a. The locale must be in the form of locale@calendar=calendar-name
b. The calendar must use the intlDateFormatter::TRADITIONAL constant, or an intlCalendar object created with a locale as specified in a.
The calendar name can be 'gregorian', even if the intlDateFormatter::TRADITIONAL constant is used, which makes for a more generic code approach.