Полный преобразователь
класс FullTransformer
Парсер и форматировщик для форматов дат.
Методы
| __construct(string $pattern, string $timezone) | ||
| Преобразователь[] | getTransformers() Возвращает массив объектов Преобразователь. | |
| string | format(DateTime $dateTime) Форматирует DateTime с использованием шаблона ICU dateformat. | |
| string | formatReplace(string $dateChars, DateTime $dateTime) Возвращает отформатированное значение ICU для соответствующих символов даты. | |
| int|false | parse(DateTime $dateTime, string $value) Парсит строку, основанную на шаблоне, в значение временной метки. | |
| string | getReverseMatchingRegExp(string $pattern) Возвращает регулярное выражение для сопоставления с отформатированным значением. | |
| bool | isQuoteMatch(string $quoteMatch) Проверяет, является ли первый символ строки одинарной кавычкой. | |
| string | replaceQuoteMatch(string $quoteMatch) Заменяет одинарные кавычки в начале или конце строки на две одинарные кавычки. | |
| string | buildCharsMatch(string $specialChars) Строит регулярное выражение для соответствия символам. | |
| array | normalizeArray(array $data) Нормализует массив результатов preg_replace, удаляя числовые ключи и возвращая ассоциативный массив со значениями и шаблонами для сопоставленного преобразователя. | |
| bool|int | calculateUnixTimestamp(DateTime $dateTime, array $options) Вычисляет временную метку Unix на основе сопоставленных значений обратным регулярным выражением сопоставления parse(). |
Подробности
__construct(string $pattern, string $timezone)
Параметры
| string | $pattern | Шаблон, используемый для форматирования и/или разбора значений |
| string | $timezone | Часовой пояс для выполнения вычислений даты/времени |
Преобразователь[] getTransformers()
Возвращает массив объектов Преобразователь.
Возвращаемое значение
| Преобразователь[] | Ассоциативный массив объектов Преобразователь (символ формата => Преобразователь) |
string format(DateTime $dateTime)
Форматирует DateTime с использованием шаблона ICU dateformat.
Параметры
| DateTime | $dateTime | Объект DateTime, используемый для генерации отформатированного значения |
Возвращаемое значение
| string | Отформатированное значение |
string formatReplace(string $dateChars, DateTime $dateTime)
Возвращает отформатированное значение ICU для соответствующих символов даты.
Параметры
| string | $dateChars | Символы даты, которые нужно заменить отформатированным значением ICU |
| DateTime | $dateTime | Объект DateTime, используемый для генерации отформатированного значения |
Возвращаемое значение
| string | Отформатированное значение |
Исключения
| NotImplementedException | При обнаружении нереализованного символа даты |
int|false parse(DateTime $dateTime, string $value)
Парсит строку, основанную на шаблоне, в значение временной метки.
Параметры
| DateTime | $dateTime | Настроенный объект DateTime, используемый для выполнения расчётов даты |
| string | $value | Строка, преобразуемая во временную метку |
Возвращаемое значение
| int|false | Соответствующая временная метка Unix |
Исключения
| InvalidArgumentException | Если значение не может быть сопоставлено с шаблоном |
string getReverseMatchingRegExp(string $pattern)
Возвращает регулярное выражение для сопоставления с отформатированным значением.
Параметры
| string | $pattern | Шаблон для создания обратного регулярного выражения сопоставления |
Возвращаемое значение
| string | Обратное регулярное выражение сопоставления с именованными группами захвата, образованными индексом преобразователя в массиве $transformer |
bool isQuoteMatch(string $quoteMatch)
Проверяет, является ли первый символ строки одинарной кавычкой.
Параметры
| string | $quoteMatch | Строка для проверки |
Возвращаемое значение
| bool | true, если совпадает, иначе false |
string replaceQuoteMatch(string $quoteMatch)
Заменяет одинарные кавычки в начале или конце строки на две одинарные кавычки.
Параметры
| string | $quoteMatch | Строка для замены кавычек |
Возвращаемое значение
| string | Строка с заменёнными одинарными кавычками |
protected string buildCharsMatch(string $specialChars)
Строит регулярное выражение для соответствия символам.
Параметры
| string | $specialChars | Строка символов для построения регулярного выражения |
Возвращаемое значение
| string | Регулярное выражение для соответствия символам |
protected array normalizeArray(array $data)
Нормализует массив результатов preg_replace, удаляя числовые ключи и возвращая ассоциативный массив со значениями и шаблонами для сопоставленного преобразователя.
Параметры
| array | $data |
Возвращаемое значение
| array |
protected bool|int calculateUnixTimestamp(DateTime $dateTime, array $options)
Вычисляет временную метку Unix на основе сопоставленных значений обратным регулярным выражением сопоставления parse().
Параметры
| DateTime | $dateTime | Объект DateTime, используемый для вычисления временной метки |
| array | $options | Массив с сопоставленными значениями, используемыми для вычисления временной метки |
Возвращаемое значение
| bool|int | Вычисленная временная метка или false, если сопоставленная дата недействительна |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/Intl/DateFormatter/DateFormat/FullTransformer.html