Spec-Zone.ru › Symfony 2.8 IntlDateFormatter class IntlDateFormatter
Замена нативный класса PHP {@link \IntlDateFormatter}.
В настоящее время в этом классе поддерживаются только следующие методы:
{@link __construct} {@link create} {@link format} {@link getCalendar} {@link getDateType} {@link getErrorCode} {@link getErrorMessage} {@link getLocale} {@link getPattern} {@link getTimeType} {@link getTimeZoneId} {@link isLenient} {@link parse} {@link setLenient} {@link setPattern} {@link setTimeZoneId} {@link setTimeZone} Константы NONE FULL LONG MEDIUM SHORT TRADITIONAL GREGORIAN
Методы __construct (string $locale, int $datetype, int $timetype, mixed $timezone = null, int $calendar = self::GREGORIAN, string $pattern = null) static IntlDateFormatter create (string $locale, int $datetype, int $timetype, string $timezone = null, int $calendar = self::GREGORIAN, string $pattern = null) Статический конструктор.
string|bool format (int|DateTime $timestamp) Форматирование значения даты/времени (timestamp) в строку.
string formatObject (object $object, mixed $format = null, string $locale = null) Не поддерживается. Форматирует объект.
int getCalendar () Возвращает календарь форматировщика.
object getCalendarObject () Не поддерживается. Возвращает объект календаря форматировщика.
int getDateType () Возвращает тип даты форматировщика.
int getErrorCode () Возвращает последний код ошибки форматировщика. Всегда возвращает значение константы UZERO ERROR.
string getErrorMessage () Возвращает последнее сообщение об ошибке форматировщика. Всегда возвращает значение константы UZERO ERROR_MESSAGE.
string getLocale (int $type = Locale::ACTUAL_LOCALE) Возвращает локаль форматировщика.
string getPattern () Возвращает шаблон форматировщика.
int getTimeType () Возвращает тип времени форматировщика.
string getTimeZoneId () Возвращает идентификатор часового пояса форматировщика.
mixed getTimeZone () Не поддерживается. Возвращает часовой пояс форматировщика.
bool isLenient () Возвращает, является ли форматировщик снисходительным.
string localtime (string $value, int $position) Не поддерживается. Разбирает строку в значение времени на основе полей.
int parse (string $value, int $position = null) Разбирает строку в значение отметки времени.
bool setCalendar (string $calendar) Не поддерживается. Устанавливает календарь форматировщика.
bool setLenient (bool $lenient) Устанавливает снисходительность анализатора.
bool setPattern (string $pattern) Устанавливает шаблон форматировщика.
bool setTimeZoneId (string $timeZoneId) Устанавливает идентификатор часового пояса форматировщика.
bool setTimeZone (mixed $timeZone) Этот метод был добавлен в PHP 5.5 как замена для setTimeZoneId().
Подробности
__construct(string $locale, int $datetype, int $timetype, mixed $timezone = null, int $calendar = self::GREGORIAN, string $pattern = null)
Параметры string $locale Код локали. В настоящее время поддерживается только "en" (или null для использования локали по умолчанию, т.е. "en") int $datetype Тип форматирования даты, один из констант типов формата int $timetype Тип форматирования времени, один из констант типов формата mixed $timezone Идентификатор часового пояса int $calendar Календарь для использования при форматировании или разборе. В настоящее время поддерживается только IntlDateFormatter::GREGORIAN (или null для использования календаря по умолчанию, т.е. "GREGORIAN") string $pattern Необязательный шаблон для использования при форматировании
Исключения См. также http://www.php.net/manual/en/intldateformatter.create.php http://userguide.icu-project.org/formatparse/datetime
static IntlDateFormatter
create(string $locale, int $datetype, int $timetype, string $timezone = null, int $calendar = self::GREGORIAN, string $pattern = null)
Статический конструктор.
Параметры string $locale Код локали. В настоящее время поддерживается только "en" (или null для использования локали по умолчанию, т.е. "en") int $datetype Тип форматирования даты, один из констант типов формата int $timetype Тип форматирования времени, один из констант типов формата string $timezone Идентификатор часового пояса int $calendar Календарь для использования при форматировании или разборе; по умолчанию — григорианский. Один из констант календарей string $pattern Необязательный шаблон для использования при форматировании
Значение, возвращаемое функцией Исключения См. также http://www.php.net/manual/en/intldateformatter.create.php http://userguide.icu-project.org/formatparse/datetime
Форматирует значение даты/времени (временную метку) как строку.
Параметры int|DateTime
$timestamp Временная метка для форматирования. Объекты \DateTime поддерживаются начиная с PHP 5.3.4.
Значение, возвращаемое функцией string|bool Отформатированное значение или false, если форматирование не удалось
Исключения См. также http://www.php.net/manual/en/intldateformatter.format.php
Не поддерживается. Форматирует объект.
Параметры object $object mixed $format string $locale
Значение, возвращаемое функцией string Отформатированное значение
Исключения См. также http://www.php.net/manual/en/intldateformatter.formatobject.php
int
getCalendar()
Возвращает календарь форматировщика.
Значение, возвращаемое функцией int Используемый календарь форматировщика. В настоящее время всегда возвращает IntlDateFormatter::GREGORIAN.
См. также http://www.php.net/manual/en/intldateformatter.getcalendar.php
object
getCalendarObject()
Не поддерживается. Возвращает объект календаря форматировщика.
Значение, возвращаемое функцией object Объект календаря, используемого форматировщиком
Исключения См. также http://www.php.net/manual/en/intldateformatter.getcalendarobject.php
int
getDateType()
Возвращает тип даты форматировщика.
Значение, возвращаемое функцией int Текущее значение форматировщика
См. также http://www.php.net/manual/en/intldateformatter.getdatetype.php
int
getErrorCode()
Возвращает код последней ошибки форматировщика. Всегда возвращает значение константы UZERO ERROR.
Значение, возвращаемое функцией int Код ошибки последнего вызова форматировщика
См. также http://www.php.net/manual/en/intldateformatter.geterrorcode.php
string
getErrorMessage()
Возвращает последнее сообщение об ошибке форматировщика. Всегда возвращает значение константы UZERO ERROR_MESSAGE.
Значение, возвращаемое функцией string Сообщение об ошибке последнего вызова форматировщика
См. также http://www.php.net/manual/en/intldateformatter.geterrormessage.php
string
getLocale(int $type = Locale::ACTUAL_LOCALE)
Возвращает локаль форматировщика.
Параметры int $type Не поддерживается. Тип имени локали для возврата (Locale::VALIDLOCALE или Locale::ACTUAL LOCALE)
Значение, возвращаемое функцией string Локаль, используемая для создания форматировщика. В настоящее время всегда возвращает "en".
См. также http://www.php.net/manual/en/intldateformatter.getlocale.php
string
getPattern()
Возвращает шаблон форматировщика.
Значение, возвращаемое функцией string Строка шаблона, используемая форматировщиком
См. также http://www.php.net/manual/en/intldateformatter.getpattern.php
int
getTimeType()
Возвращает тип времени форматировщика.
Значение, возвращаемое функцией int Тип времени, используемый форматировщиком
См. также http://www.php.net/manual/en/intldateformatter.gettimetype.php
string
getTimeZoneId()
Возвращает идентификатор часового пояса форматировщика.
Значение, возвращаемое функцией string Идентификатор часового пояса, используемый форматировщиком
См. также http://www.php.net/manual/en/intldateformatter.gettimezoneid.php
mixed
getTimeZone()
Не поддерживается. Возвращает часовой пояс форматировщика.
Значение, возвращаемое функцией mixed Часовой пояс, используемый форматировщиком
Исключения См. также http://www.php.net/manual/en/intldateformatter.gettimezone.php
bool
isLenient()
Возвращает, является ли форматировщик снисходительным.
Значение, возвращаемое функцией bool В настоящее время всегда возвращает false
Исключения См. также http://www.php.net/manual/en/intldateformatter.islenient.php
string
localtime(string $value, int $position)
Не поддерживается. Разбор строки в значение времени на основе полей.
Параметры string $value Строка для преобразования в значение времени int $position Позиция для начала разбора в $value (нумерация с нуля) Если ошибка не возникает до завершения разбора $value, $parse_pos будет содержать -1, в противном случае — позицию, на которой закончился разбор. Если $parse_pos > strlen($value), разбор завершается немедленно с ошибкой.
Возвращаемое значение string Массив целых чисел, совместимый с localtime: содержит значение 24-часового формата в поле tm_hour
Исключения См. также http://www.php.net/manual/en/intldateformatter.localtime.php
int
parse(string $value, int $position = null)
Разбор строки в значение временной метки.
Параметры string $value Строка для преобразования в значение времени int $position Не поддерживается. Позиция для начала разбора в $value (нумерация с нуля) Если ошибка не возникает до завершения разбора $value, $parse_pos будет содержать -1, в противном случае — позицию, на которой закончился разбор. Если $parse_pos > strlen($value), разбор завершается немедленно с ошибкой.
Возвращаемое значение int Разборённое значение в формате временной метки
Исключения См. также http://www.php.net/manual/en/intldateformatter.parse.php
bool
setCalendar(string $calendar)
Не поддерживается. Установка календаря форматировщика.
Параметры string $calendar Используемый календарь. По умолчанию IntlDateFormatter::GREGORIAN
Возвращаемое значение bool true при успехе или false при ошибке
Исключения См. также http://www.php.net/manual/en/intldateformatter.setcalendar.php
bool
setLenient(bool $lenient)
Установка допуска к разбору.
Определяет, является ли разборщик строгим или допускающим неточности при интерпретации входных данных, не точно соответствующих шаблону. Включение допускаемого разбора позволяет разборщику принимать даты или время с ошибками, обрабатывая как можно больше данных для получения значения. Дополнительные пробелы, нераспознанные токены или некорректные значения ("30 февраля") не принимаются.
Параметры bool $lenient Устанавливает, является ли разборщик допускающим неточности или строгим. В настоящее время поддерживается только false (строгий).
Возвращаемое значение bool true при успехе или false при ошибке
Исключения См. также http://www.php.net/manual/en/intldateformatter.setlenient.php
bool
setPattern(string $pattern)
Установить шаблон форматировщика.
Параметры string $pattern Строка шаблона, соответствующая документации ICU IntlDateFormatter
Возвращаемое значение bool true при успехе или false при ошибке
См. также http://www.php.net/manual/en/intldateformatter.setpattern.php http://userguide.icu-project.org/formatparse/datetime
bool
setTimeZoneId(string $timeZoneId)
Установить идентификатор часового пояса форматировщика.
Параметры string $timeZoneId Строка идентификатора часового пояса. Если NULL или пустая строка, используется по умолчанию для текущей среды выполнения.
Возвращаемое значение bool true при успехе или false при ошибке
См. также http://www.php.net/manual/en/intldateformatter.settimezoneid.php
bool
setTimeZone(mixed $timeZone)
Этот метод был добавлен в PHP 5.5 как замена setTimeZoneId().
Параметры Возвращаемое значение bool true при успехе или false при ошибке
См. также http://www.php.net/manual/en/intldateformatter.settimezone.php
