Работа с датами и типами в D7

Ядро D7 отказалось от «сырых» строк с датами в пользу объектов-обёрток. Правильная работа с типами Bitrix\Main\Type\DateTime и полями ORM избавляет от ошибок часовых поясов, форматирования и приведения значений при записи в базу.

Объекты Date и DateTime вместо строк

В D7 дата — это не строка формата сайта, а объект. Основные классы лежат в пространстве имён Bitrix\Main\Type:

• Bitrix\Main\Type\Date — только дата, без времени;
• Bitrix\Main\Type\DateTime — дата и время (наследник Date);

Оба класса — обёртки над PHP \DateTime, поэтому поддерживают арифметику через add() и относительные интервалы. Создание из строки в формате сайта и из произвольного формата различается:

use Bitrix\Main\Type\DateTime;
$now = new DateTime(); // текущий момент
$dt = DateTime::createFromUserTime('16.07.2026 12:30:00');
$fromFormat = new DateTime('2026-07-16 12:30:00', 'Y-m-d H:i:s');
$dt->add('3 days')->add('-2 hours');

Часовые пояса и хранение времени

Если в настройках сайта включены часовые пояса (Настройки → Настройки продукта → Часовой пояс), ядро хранит время в БД в серверном поясе, а показывает в пользовательском. Ключевые функции:

Типичная ошибка — сравнивать даты из ORM и «руками» собранные без учёта пояса. Перед пакетными операциями (импорт, обмен) пояс часто отключают:

\CTimeZone::Disable();
// массовая запись дат в БД в серверном времени
\CTimeZone::Enable();

Скалярные типы полей ORM

В ORM тип значения задаёт класс поля из Bitrix\Main\ORM\Fields. Именно поле отвечает за приведение значения при чтении из БД и при записи. Основные скалярные типы:

Тип объявляется в методе getMap() таблицы. Обратите внимание: имена классов D7 (Bitrix\Main\ORM\Fields\DatetimeField) вытеснили старые Entity\DatetimeField, которые оставлены для совместимости.

BooleanField и EnumField: значения по правилам

BooleanField в Битрикс не хранит настоящий SQL BOOLEAN — он маппит два строковых значения на false и true. Это удобно для привычного битриксового 'N'/'Y':

(new BooleanField('ACTIVE'))
  ->configureValues('N', 'Y')
  ->configureDefaultValue('N');

EnumField ограничивает множество допустимых значений — при валидации значение вне списка отклоняется:

(new EnumField('STATUS'))
  ->configureValues(['NEW', 'PAID', 'DONE']);

• для BooleanField первое значение в configureValues соответствует false, второе — true;
• EnumField не приводит регистр — храните значения консистентно;
• оба типа проверяются при add()/update() и бросают Result с ошибкой.

Запись и чтение значений через ORM

При добавлении записи вы передаёте объекты нужного типа, а поле само сериализует их в SQL. Пример с датой и булевым полем:

use Bitrix\Main\Type\DateTime;
OrderTable::add([
  'ACTIVE' => true,
  'STATUS' => 'NEW',
  'DATE_CREATE' => new DateTime(),
  'SUM' => 1990.50,
]);

При выборке значения приходят уже типизированными — не нужно вручную парсить строки:

$row = OrderTable::getRow(['filter' => ['=ID' => 42]]);
$row['DATE_CREATE']->format('d.m.Y'); // объект DateTime
var_dump($row['ACTIVE']); // bool(true)

• чтобы отфильтровать по интервалу дат, передавайте объекты DateTime, а не строки;
• для сравнения «сегодня» удобно Bitrix\Main\Type\Date без времени;
• если нужно чистое SQL-выражение (NOW()), используйте Bitrix\Main\DB\SqlExpression.

SqlExpression и приведение на стороне БД

Иногда значение должна вычислить сама база — например, проставить текущую метку времени средствами СУБД. Для этого есть Bitrix\Main\DB\SqlExpression:

use Bitrix\Main\DB\SqlExpression;
LogTable::add([
  'MESSAGE' => 'sync',
  'TS' => new SqlExpression('NOW()'),
]);

Плейсхолдеры %s экранируются, что защищает от инъекций:

new SqlExpression('DATE_ADD(?#, INTERVAL 1 DAY)', 'DATE_CREATE');

Итог

Типизация — фундамент предсказуемого кода на D7. Работайте с датами как с объектами Date/DateTime, помните про createFromUserTime() и часовые пояса, а в getMap() подбирайте поле под смысл данных: BooleanField с маппингом, EnumField с валидацией, SqlExpression для вычислений на стороне БД. Так вы избегаете классических багов со сдвигом времени и «строковыми» датами.

Мы в B2Bsite проектируем модель данных на D7 с корректной типизацией и работой поясов при интеграциях с 1С и внешними сервисами. Если нужен обмен, где даты и статусы приходят из разных систем без искажений, поможем спроектировать надёжный слой хранения и синхронизации.