Создать объект из строки без исключения DateTime::tryParse
Модуль: main — подключать отдельно не нужно
Метод DateTime::tryParse создает объект из строки конструктором и перехватывает исключение Bitrix\Main\ObjectException. Вместо исключения метод возвращает null.
Сигнатура метода в классе Bitrix\Main\Type\DateTime:
public static function tryParse($timeString, $format = null)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| timeString* | string |
Задает дату со временем строкой |
| format | ?string |
Задает маску PHP, например 'Y-m-d H:i:s'. Если передать null, метод берет формат даты и времени из региональных настроек. По умолчанию — null |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает объект DateTime или null, если строка пустая или конструктор не разобрал ее.
Особенности
- Для значения
nullвtimeStringметод возвращает текущее время, а неnull. Проверяйте значение наnullдо вызова. - Метод разбирает строку так же нестрого, как конструктор. Например, несуществующий день переходит на следующий месяц.
Примеры
Пример. Код разбирает значение из запроса и подставляет текущее время, если значение не подошло:
<?php
use Bitrix\Main\Application;
use Bitrix\Main\Type\DateTime;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$value = (string)Application::getInstance()->getContext()->getRequest()->get('date_from');
$dateFrom = DateTime::tryParse($value, 'Y-m-d H:i') ?? new DateTime();
echo $dateFrom->format('Y-m-d H:i');
Код выведет значение параметра date_from, например 2026-01-15 10:00. Без параметра код выведет текущие дату и время.