PHP Manual
intl
Класс IntlDateFormatter

Класс IntlDateFormatter

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

Введение

Это класс позволяющий форматировать/разбирать даты в соответствиями с настройками локали, используя строковые и/или библиотечные шаблоны.

Класс предоставляет функционал форматирования дат ICU. Он позволяет пользователям отображать даты в формате, принятым в их локали. Или разбирать значения дат используя строковые и/или библиотечные шаблоны.

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

IntlDateFormatter {

/* Методы */

public __construct ( string $locale , int $datetype , int $timetype , mixed $timezone = NULL , mixed $calendar = NULL , string $pattern = "" )

public static create ( string $locale , int $datetype , int $timetype , mixed $timezone = NULL , mixed $calendar = NULL , string $pattern = "" ) : IntlDateFormatter

public format ( mixed $value ) : string

public static formatObject ( object $object , mixed $format = NULL , string $locale = NULL ) : string|false

public getCalendar ( ) : int

public getDateType ( ) : int

public getErrorCode ( ) : int

public getErrorMessage ( ) : string

public getLocale ( int $which = ? ) : string

public getPattern ( ) : string

public getTimeType ( ) : int

public getTimeZoneId ( ) : string

public getCalendarObject ( ) : IntlCalendar

public getTimeZone ( ) : IntlTimeZone|false

public isLenient ( ) : bool

public localtime ( string $value , int &$position = ? ) : array

public parse ( string $value , int &$position = ? ) : int

public setCalendar ( mixed $which ) : bool

public setLenient ( bool $lenient ) : bool

public setPattern ( string $pattern ) : bool

public setTimeZoneId ( string $zone ) : bool

public setTimeZone ( mixed $zone ) : bool

}

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

» Форматирование дат ICU

» Форматы дат ICU

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

Эти константы используются для задания формата в конструкторах 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): Григорианский календарь

Содержание

IntlDateFormatter::create — Create a date formatter
IntlDateFormatter::format — Format the date/time value as a string
IntlDateFormatter::formatObject — Formats an object
IntlDateFormatter::getCalendar — Get the calendar type used for the IntlDateFormatter
IntlDateFormatter::getDateType — Get the datetype used for the IntlDateFormatter
IntlDateFormatter::getErrorCode — Get the error code from last operation
IntlDateFormatter::getErrorMessage — Get the error text from the last operation
IntlDateFormatter::getLocale — Get the locale used by formatter
IntlDateFormatter::getPattern — Get the pattern used for the IntlDateFormatter
IntlDateFormatter::getTimeType — Get the timetype used for the IntlDateFormatter
IntlDateFormatter::getTimeZoneId — Get the timezone-id used for the IntlDateFormatter
IntlDateFormatter::getCalendarObject — Get copy of formatterʼs calendar object
IntlDateFormatter::getTimeZone — Get formatterʼs timezone
IntlDateFormatter::isLenient — Get the lenient used for the IntlDateFormatter
IntlDateFormatter::localtime — Parse string to a field-based time value
IntlDateFormatter::parse — Parse string to a timestamp value
IntlDateFormatter::setCalendar — Sets the calendar type used by the formatter
IntlDateFormatter::setLenient — Set the leniency of the parser
IntlDateFormatter::setPattern — Set the pattern used for the IntlDateFormatter
IntlDateFormatter::setTimeZoneId — Sets the time zone to use
IntlDateFormatter::setTimeZone — Sets formatterʼs timezone