Класс IntlDateFormatter

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

    Введение

    Средство форматирования дат — класс, который форматирует или разбирает даты через строковые и (или) библиотечные шаблоны с учётом языковых настроек.

    Класс поддерживает функциональность форматирования дат по стандарту ICU и помогает пользователям отображать даты в формате, который учитывает настройки локали, или разбирать строки в значения PHP-дат через строковые и (или) готовые шаблоны.

    Синопсис класса

    class IntlDateFormatter {
    /* Константы */
    public const int FULL;
    public const int LONG;
    public const int MEDIUM;
    public const int SHORT;
    public const int NONE;
    public const int RELATIVE_FULL;
    public const int RELATIVE_LONG;
    public const int RELATIVE_MEDIUM;
    public const int RELATIVE_SHORT;
    public const int GREGORIAN;
    public const int TRADITIONAL;
    /* Методы */
    public __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
    )
    public static 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 format(IntlCalendar|DateTimeInterface|array|string|int|float $datetime): string|false
    public static formatObject(IntlCalendar|DateTimeInterface $datetime, array|int|string|null $format = null, ?string $locale = null): string|false
    public getCalendar(): int|false
    public getDateType(): int|false
    public getErrorCode(): int
    public getErrorMessage(): string
    public getLocale(int $type = ULOC_ACTUAL_LOCALE): string|false
    public getPattern(): string|false
    public getTimeType(): int|false
    public getTimeZoneId(): string|false
    public getCalendarObject(): IntlCalendar|false|null
    public getTimeZone(): IntlTimeZone|false
    public isLenient(): bool
    public localtime(string $string, int &$offset = null): array|false
    public parse(string $string, int &$offset = null): int|float|false
    public setCalendar(IntlCalendar|int|null $calendar): bool
    public setLenient(bool $lenient): void
    public setPattern(string $pattern): bool
    public setTimeZone(IntlTimeZone|DateTimeZone|string|null $timezone): bool
    }

    Предопределённые константы

    Константы устанавливают формат в конструкторах DateType и TimeType.

    IntlDateFormatter::NONE int
    Не включать этот элемент
    IntlDateFormatter::FULL int
    Полный формат (Tuesday, April 12, 1952 AD or 3:30:42pm PST)
    IntlDateFormatter::LONG int
    Длинный формат (January 12, 1952 or 3:30:32pm)
    IntlDateFormatter::MEDIUM int
    Средний формат (Jan 12, 1952)
    IntlDateFormatter::SHORT int
    Наиболее сокращённый формат, только самые необходимые данные (12/13/52 или 3:30pm)
    IntlDateFormatter::RELATIVE_FULL int
    То же, что и константа IntlDateFormatter::FULL, но «вчера», «сегодня» и «завтра» выводятся как yesterday, today и tomorrow. Константа доступна с PHP 8.0.0 только для параметра dateType.
    IntlDateFormatter::RELATIVE_LONG int
    То же, что и константа IntlDateFormatter::LONG, но «вчера», «сегодня» и «завтра» выводятся как yesterday, today и tomorrow. Константа доступна с PHP 8.0.0 только для параметра dateType.
    IntlDateFormatter::RELATIVE_MEDIUM int
    То же, что и константа IntlDateFormatter::MEDIUM, но «вчера», «сегодня» и «завтра» выводятся как yesterday, today и tomorrow. Константа доступна с PHP 8.0.0 только для параметра dateType.
    IntlDateFormatter::RELATIVE_SHORT int
    То же, что и константа IntlDateFormatter::SHORT, но но «вчера», «сегодня» и «завтра» выводятся как yesterday, today и tomorrow. Константа доступна с PHP 8.0.0 только для параметра dateType.

    Следующие константы устанавливают тип календаря. Эти календари прямо завязаны на Григорианский календарь. Не Григорианский календарь устанавливается в локали. Например, locale="hi@calendar=BUDDHIST".

    IntlDateFormatter::TRADITIONAL int
    Не Григорианский календарь
    IntlDateFormatter::GREGORIAN int
    Григорианский календарь

    Список изменений

    Версия Описание
    8.4.0 Константы класса стали типизированными.

    Содержание

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей

    Пользователи ещё не добавляли примечания для страницы
    To Top