IntlDateFormatter::create
datefmt_create
IntlDateFormatter::__construct
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
IntlDateFormatter::create -- datefmt_create -- IntlDateFormatter::__construct — Створює засіб форматування дати
Опис
Об'єктно-орієнтований стиль
public static IntlDateFormatter::create( ?string $locale, int $dateType = IntlDateFormatter::FULL, int $timeType = IntlDateFormatter::FULL, IntlTimeZone|DateTimeZone|string|null $timezone = null, IntlCalendar|int|null $calendar = null, ?string $pattern = null): ?IntlDateFormatter
Об'єктно-орієнтований стиль (конструктор)
public IntlDateFormatter::__construct
?string$locale
,
int$dateType
= IntlDateFormatter::FULL,
int$timeType
= IntlDateFormatter::FULL,
IntlTimeZone DateTimeZone|string|null$timezone
null
,
IntlCalendar|int|null$calendar
null
,
?string$pattern
null
) .
Процедурний стиль
datefmt_create( ?string $locale, int $dateType, int $timeType, IntlTimeZone|DateTimeZone|string|null $timezone = null, IntlCalendar|int|null $calendar = null, string $pattern = ""): ?IntlDateFormatter
Створює засіб форматування дати.
Список параметрів
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
**в случае возникновения ошибки.
список змін
Версия | Опис |
---|---|
8.1.0 | |
Тепер параметри dateType иtimeType необов'язкові. |
Приклади
Приклад #1 Приклад використання datefmt_create()****
Loading...
Приклад #2 OO example
Loading...
Приклад #3 Приклад обробки неправильного значення мовного стандарту
Loading...
Результат виконання наведеного прикладу:
Первый форматированный вывод: 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
Дивіться також
- datefmt_format() - Форматує значення дати/часу у вигляді рядка
- datefmt_parse() - Перетворює рядок на значення позначки часу
- datefmt_get_error_code() - Отримує код помилки останньої операції
- datefmt_get_error_message() - Отримує текст помилки останньої операції