Распознать дату в тексте Date::createFromText
Модуль: main — подключать отдельно не нужно
Метод Date::createFromText находит в тексте дату и возвращает ее объектом DateTime. Метод распознает числовые даты и слова из словаря текущего языка, например «завтра» или «вчера» на русском, tomorrow или yesterday на английском.
Метод передает текст в метод Bitrix\Main\Text\DateConverter::decode и берет первый элемент результата. Порядок элементов задают приоритеты видов дат в DateConverter, а не позиция в тексте.
Сигнатура метода в классе Bitrix\Main\Type\Date:
public static function createFromText($text)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| text* | string |
Задает текст, в котором метод ищет дату |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает объект DateTime, а не Date, в том числе при вызове Date::createFromText. Если текст пустой или даты в нем нет, метод возвращает null.
Особенности
- Словарь зависит от текущего языка. На сайте это язык сайта, в административном разделе — язык интерфейса. На русском языке метод не распознает слово
tomorrow. - Если в тексте нет времени, метод подставляет время по виду даты. Для слова «завтра» и даты без времени метод берет время окончания рабочего дня, для части других фраз — время начала рабочего дня, для середины периода —
14:00. Время начала и окончания метод читает из параметровwork_time_startиwork_time_endмодуляcalendar, без них берет9:00и18:00.
Примеры
Пример. Код распознает дату со временем и дату без времени:
<?php
use Bitrix\Main\Type\Date;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$withTime = Date::createFromText('15.01.2026 10:30');
$withoutTime = Date::createFromText('15.01.2026');
echo $withTime?->format('Y-m-d H:i') . ' ' . $withoutTime?->format('Y-m-d H:i');
Без параметров рабочего времени модуля calendar код выведет 2026-01-15 10:30 2026-01-15 18:00.
Пример. Код распознает слово «завтра» на русском языке и выводит класс и время результата:
<?php
use Bitrix\Main\Type\Date;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$date = Date::createFromText('завтра');
echo $date === null ? 'Дата не найдена' : get_class($date) . ' ' . $date->format('H:i');
Без параметров рабочего времени модуля calendar код выведет Bitrix\Main\Type\DateTime 18:00. Дата в объекте — завтрашняя.