Класс 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 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

}

Смотрите также

» Средство форматирования дат по стандарту ICU

» Синтаксис формата дат по стандарту ICU

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

Эти константы используются для задания формата в конструкторах DateType и TimeType.

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

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

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

Содержание

IntlDateFormatter::create — Создаёт средство форматирования даты
IntlDateFormatter::format — Форматирует значение даты и времени как строку
IntlDateFormatter::formatObject — Форматирует объект
IntlDateFormatter::getCalendar — Получает тип календаря для объекта IntlDateFormatter
IntlDateFormatter::getDateType — Получает тип даты, используемый IntlDateFormatter
IntlDateFormatter::getErrorCode — Получает код ошибки последней операции
IntlDateFormatter::getErrorMessage — Получает текст ошибки последней операции
IntlDateFormatter::getLocale — Получает языковой стандарт, используемый средством форматирования
IntlDateFormatter::getPattern — Получает шаблон, используемый IntlDateFormatter
IntlDateFormatter::getTimeType — Получает тип времени, используемый IntlDateFormatter
IntlDateFormatter::getTimeZoneId — Получает идентификатор часового пояса, используемый IntlDateFormatter
IntlDateFormatter::getCalendarObject — Получает копию объекта календаря средства форматирования
IntlDateFormatter::getTimeZone — Получает часовой пояс средства форматирования
IntlDateFormatter::isLenient — Получает снисходительность, используемую для IntlDateFormatter
IntlDateFormatter::localtime — Преобразовывает строку в значение времени на основе поля
IntlDateFormatter::parse — Преобразовывает строку в значение отметки времени
IntlDateFormatter::setCalendar — Устанавливает тип календаря для средства форматирования
IntlDateFormatter::setLenient — Устанавливает мягкий режим анализатора
IntlDateFormatter::setPattern — Устанавливает шаблон, используемый IntlDateFormatter
IntlDateFormatter::setTimeZone — Устанавливает часовой пояс средства форматирования

Улучшение страницы

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

＋Добавить

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

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