« IntlDateFormatter::createIntlDateFormatter::formatObject »PHP ManualIntlDateFormatter

IntlDateFormatter::format

datefmt_format

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

IntlDateFormatter::format -- datefmt_format — Форматує значення дати/часу у вигляді рядка

Опис

Об'єктно-орієнтований стиль

public IntlDateFormatter::format(IntlCalendar|DateTimeInterface|array|string|int|float $datetime): string|false

Процедурний стиль

datefmt_format(IntlDateFormatter $formatter, IntlCalendar|DateTimeInterface|array|string|int|float $datetime): string|false

Форматує значення дати/часу у вигляді рядка.

Список параметрів

formatter

Ресурс засобу форматування дати.

datetime

Значення форматування. Це може бути об'єкт DateTimeInterface, об'єкт IntlCalendar, тип numeric, що представляє (можливо, дробову) кількість секунд від початку епохи Unix або масив (array) у форматі, що виводиться функцією localtime()

Якщо передається об'єкт DateTime або IntlCalendar, його часовий пояс не враховується. Об'єкт буде відформатований за допомогою часового поясу засобу форматування. Якщо хтось хоче використовувати часовий пояс об'єкта, який потрібно відформатувати, потрібно викликати функцію IntlDateFormatter::setTimeZone() з часового поясу об'єкта. Як альтернативу замість неї може використовуватися статична функція IntlDateFormatter::formatObject()

Значення, що повертаються

Відформатований рядок або **false**в случае возникновения ошибки.

список змін

ВерсияОпис
7.1.5Додано підтримку надання спільних об'єктів DateTimeInterfaceдля параметраdatetime. . Раніше підтримувалися лише об'єкти DateTime
PECL 3.0.0Додано підтримку надання об'єктів IntlCalendarдля параметраdatetime

Приклади

Приклад #1 Приклад використання datefmt_format()****

Loading...

Приклад #2 Приклад використання в об'єктно-орієнтованому стилі

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

Приклад #3 Приклад використання об'єкта IntlCalendar

Loading...

Результат виконання наведеного прикладу:

В этом исламском году Рамадан начался/начнётся:
    mardi 9 juillet 2013 19:00:00 heure avancée d’Europe centrale
После изменения часового пояса:
    mercredi 10 juillet 2013 02:00:00 heure normale du Japon

Дивіться також