1С Битрикс · 7 мин чтения

DateTime в Битрикс D7: форматы дат и фильтры по времени в выборках

Работаю с датами в D7 почти на каждом проекте на Битриксе: то нужно выбрать заказы за прошлый месяц, то отфильтровать элементы инфоблока по дате мероприятия, то посчитать разницу между двумя timestamp для отчёта. DateTime в Битрикс D7 устроен иначе, чем в старом ядре, и путаница между форматом хранения и форматом вывода - самая частая причина, почему фильтр в getList вдруг не находит ни одной записи, хотя данные в базе точно есть. Разберу, как класс \Bitrix\Main\Type\DateTime работает с форматами дат, как в D7 фактически хранятся даты в таблицах и инфоблоках, и как правильно строить фильтры по времени в ORM getList, CIBlockElement::GetList и CUser::GetList.

Чем DateTime в D7 отличается от старого ядра Битрикса

В старом ядре дата это строка в формате сайта или timestamp, а перевод между ними шёл через функции вроде ConvertTimeStamp и MakeTimeStamp. D7 добавил объектный слой: \Bitrix\Main\Type\Date и \Bitrix\Main\Type\DateTime, которые оборачивают стандартный PHP DateTime и умеют работать с часовым поясом сайта.

В документации по CUser::GetList прямо написано: «Лучше использовать новое ядро: \Bitrix\Main\UserTable::getList(array(“filter”=>array(“=LID” => ‘s1’)));». Это касается не только выборки пользователей, но и работы с датами вообще: в ORM даты стали объектами, а не строками, которые приходится парсить руками при каждом сравнении.

На практике это значит следующее: там, где раньше в фильтр или в SQL шла строка «31.12.2026», в D7 в фильтр ORM нужно передавать объект DateTime, а строка в фильтре старого CIBlockElement::GetList остаётся строкой, но уже в другом формате хранения. Смешение этих двух миров и даёт большую часть багов с датами в проектах на Битриксе.

Форматы даты в DateTime: как задать и как вывести значение

Конструктор \Bitrix\Main\Type\DateTime принимает строку даты и формат этой строки в нотации PHP date() (d, m, Y, H, i, s и так далее); если формат не передан, берётся формат текущего сайта. Если не передать ничего, объект создаётся с текущими датой и временем сайта. Для вывода используется format() с тем же PHP-форматом. Не путайте её с нотацией сайта (DD, MM, YYYY, HH, MI, SS), в которой работают функции старого ядра (MakeTimeStamp, ConvertDateTime, CSite::GetDateFormat). Если строка не соответствует переданному формату, конструктор выбрасывает Bitrix\Main\ObjectException.

use Bitrix\Main\Type\DateTime;

$now = new DateTime();
$fromString = new DateTime('31.12.2026 23:59:59', 'd.m.Y H:i:s');
$fromTimestamp = DateTime::createFromTimestamp(time());

echo $now->format('d.m.Y H:i:s');
$now->add('P1D');
echo $now->format('d.m.Y');

createFromTimestamp() удобен, когда дата приходит из внешнего API в unix-времени, например из вебхука Битрикс24 или из ответа сервиса доставки по трек-номеру: там дата обычно уже готовый timestamp, и превращать её в DateTime через промежуточные строки не нужно. add() принимает интервал в формате ISO 8601 (P1D - плюс сутки, PT1H - плюс час), это тот же формат, что у стандартного PHP DateInterval.

Бесплатный материал

🎁 Полезный скрипт в подарок

Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.

Без спама. Отписка в 1 клик.

Как в D7 хранятся даты в базе: строка, а не то, что вы думаете

Для свойств инфоблока типа «Дата/Время» документация фиксирует формат хранения дословно: «свойство типа Дата/Время хранится как строковое с датой в формате YYYY-MM-DD HH:MI:SS.» Это не формат сайта (обычно в русской локали это DD.MM.YYYY) и не timestamp, а фиксированная строка внутри базы.

Если сравнивать значение свойства со строкой вида «31.12.2026», фильтр не найдёт совпадений: строки не совпадают побайтово, а на уровне CIBlockElement::GetList автоматического приведения форматов нет. Отсюда практическое правило: при фильтрации по PROPERTY_<CODE> для дат значение в фильтре нужно готовить в формате YYYY-MM-DD HH:MI:SS, а не брать из пользовательского ввода как есть.

Фильтры по датам в ORM getList

Метод getList в D7 ORM принимает фильтр с закрытым списком операторов. В документации это зафиксировано дословно: «В \Bitrix\Main\ORM\Query\Filter\Operator::$operators доступны следующие операторы: =, <>, !=, <, <=, >, >=, in, between, like, exists.» Для диапазона дат чаще всего не нужен отдельный оператор between, достаточно двух условий с префиксами >= и <= прямо в ключе фильтра.

use Bitrix\Main\Loader;
use Bitrix\Sale\Internals\OrderTable;
use Bitrix\Main\Type\DateTime;

Loader::includeModule('sale');

$dateFrom = new DateTime('01.09.2026', 'd.m.Y');
$dateTo = new DateTime('30.09.2026 23:59:59', 'd.m.Y H:i:s');

$result = OrderTable::getList([
    'select' => ['ID', 'DATE_INSERT', 'PRICE'],
    'filter' => [
        '>=DATE_INSERT' => $dateFrom,
        '<=DATE_INSERT' => $dateTo,
    ],
    'order' => ['DATE_INSERT' => 'DESC'],
]);

while ($order = $result->fetch()) {
    echo $order['ID'] . ': ' . $order['DATE_INSERT']->format('d.m.Y H:i');
}

Важный момент: если поле в сущности замаплено как дата или дата-время, в фильтр нужно передавать объект \Bitrix\Main\Type\DateTime, а не голую строку. Строка «01.09.2026» в фильтре по такому полю либо не сработает, либо будет обработана не так, как ожидается, если её формат не совпадает с тем, что нужно ORM. Отдельно документация уточняет проверку на пустое значение: «’!==NAME’ => null - NAME не равно NULL. В SQL - NAME IS NOT NULL.» Тот же приём работает и для полей дат.

Ключ фильтра Что означает Пример
=NAME точное совпадение '=DATE_INSERT'
!=NAME или <>NAME не равно '!=DATE_INSERT'
>NAME, >=NAME больше, больше или равно '>=DATE_INSERT'
<NAME, <=NAME меньше, меньше или равно '<=DATE_INSERT'
!==NAME поле не равно NULL, то есть заполнено '!==DATE_INSERT' => null

Фильтры по дате в старом ядре: CIBlockElement::GetList и CUser::GetList

Для инфоблоков дата свойства передаётся в фильтре строкой в формате хранения, о котором я писал выше.

$arFilter = [
    'IBLOCK_ID' => $iblockId,
    '>=PROPERTY_EVENT_DATE' => '2026-09-01 00:00:00',
    '<=PROPERTY_EVENT_DATE' => '2026-09-30 23:59:59',
];

$res = CIBlockElement::GetList(
    ['SORT' => 'ASC'],
    $arFilter,
    false,
    false,
    ['ID', 'IBLOCK_ID', 'NAME', 'PROPERTY_EVENT_DATE']
);

while ($arFields = $res->GetNext()) {
    echo $arFields['NAME'] . ': ' . $arFields['PROPERTY_EVENT_DATE_VALUE'];
}

У CUser::GetList закрытый список ключей фильтра по датам гораздо уже, чем кажется на первый взгляд. В документации перечислены TIMESTAMP_1 и TIMESTAMP_2 (диапазон по дате последнего изменения), LAST_LOGIN_1 и LAST_LOGIN_2 (диапазон по последнему входу), PERSONAL_BIRTHDAY_1 и PERSONAL_BIRTHDAY_2 (диапазон по дню рождения). А вот ключа для фильтрации по дате регистрации в этом перечне нет: DATE_REGISTER документирован только как значение параметра сортировки by, но не как индекс фильтра. Ключ просто тихо игнорируется, PHP не кидает ошибку, а фильтр возвращает пользователей без ограничения по дате - баг находишь только сверкой с перечнем допустимых индексов в справке.

$arFilter = [
    'ACTIVE' => 'Y',
    'TIMESTAMP_1' => '01.09.2026',
    'TIMESTAMP_2' => '30.09.2026',
];

$by = 'id';
$order = 'desc';
$res = CUser::GetList($by, $order, $arFilter);

while ($arUser = $res->Fetch()) {
    echo $arUser['LOGIN'] . ': ' . $arUser['TIMESTAMP_X'];
}

Если нужна именно дата регистрации, а не дата последнего изменения, логичный путь - перейти на \Bitrix\Main\UserTable::getList() из D7: там нет закрытого перечня ключей фильтра старого ядра, любое поле сущности фильтруется общими операторами ORM, включая префиксы >= и <=. Если нужна разовая правка фильтра по датам под конкретный проект без переписывания всего модуля, этим занимается моя доработка и поддержка 1С-Битрикс, беру такие задачи от одного часа.

Частые ошибки с датами и временем в D7

  • Смешение формата хранения свойства инфоблока (YYYY-MM-DD HH:MI:SS) с форматом сайта при построении фильтра - самая частая причина пустой выборки.
  • Передача обычной строки вместо объекта DateTime в фильтр ORM по полю, замапленному как дата или дата-время.
  • Использование DATE_REGISTER как ключа фильтра в CUser::GetList - ключ не документирован и не работает.
  • Расчёт на префиксы (!=, >, <) в ключах фильтра CUser::GetList для дат: в перечне индексов фильтра для дат есть готовые пары TIMESTAMP_1/TIMESTAMP_2, LAST_LOGIN_1/LAST_LOGIN_2 и PERSONAL_BIRTHDAY_1/PERSONAL_BIRTHDAY_2, ими и нужно пользоваться.
  • Забытый часовой пояс при сравнении даты из внешнего API (например, вебхука Битрикс24) с датой, которую отдаёт DateTime сайта.

Документация Битрикса и API Битрикс24 меняются, поэтому перед тем как закладывать конкретный формат фильтра в новый проект, я сверяюсь с актуальной справкой на dev.1c-bitrix.ru.

Частые вопросы

Как получить текущую дату сайта в нужном формате через DateTime в D7?

Создайте объект без параметров и вызовите format() с PHP-форматом: (new \Bitrix\Main\Type\DateTime())->format(‘d.m.Y H:i:s’). Формат в format() это обычные буквы d, m, Y, H, i, s из стандартного PHP date(); тот же формат передаётся вторым параметром в конструктор при разборе входной строки, а буквы DD.MM.YYYY относятся к нотации сайта старого ядра.

Почему фильтр по дате в CIBlockElement::GetList не находит записи?

Чаще всего в фильтр передана строка в формате сайта (например «31.12.2026»), а свойство типа Дата/Время в базе хранится строкой в формате YYYY-MM-DD HH:MI:SS. Приведите значение фильтра к этому формату, и сравнение начнёт работать.

Можно ли сравнивать даты через операторы > и < в фильтре ORM getList?

Да, закрытый список операторов ORM включает =, <>, !=, <, <=, >, >=, in, between, like и exists, и они применимы к любому полю, включая дату, если задавать их через префикс к ключу фильтра, например ‘>=DATE_INSERT’.

Как отфильтровать пользователей по дате регистрации, если ключ DATE_REGISTER в CUser::GetList не работает?

В старом ядре подходящего ключа фильтра для даты регистрации в перечне допустимых индексов нет. Переходите на \Bitrix\Main\UserTable::getList() из D7: там фильтрация идёт по общим правилам ORM без закрытого перечня индексов старого ядра.

Есть задача?

Обсудим вашу задачу

Оставьте заявку — обсудим объём работ и следующий шаг.

Продолжая пользование настоящим сайтом Вы выражаете своё согласие на обработку Ваших персональных данных (файлов куки) с использованием Yandex.Metrika.
Понятно