Создать дату Date::__construct

Модуль: main — подключать отдельно не нужно

Конструктор Date::__construct создает дату из строки. Без строки конструктор создает текущую дату. Время объекта всегда 00:00:00 в часовом поясе сервера.

Сигнатура метода в классе Bitrix\Main\Type\Date:

public function __construct($date = null, $format = null)

Параметры

Параметр Тип Описание
date ?string Задает дату строкой. Если передать null или пустую строку, конструктор создает текущую дату. По умолчанию — null
format ?string Задает маску PHP, например 'Y-m-d'. Если передать null, конструктор берет формат даты из региональных настроек методом getFormat. По умолчанию — null

Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.

Исключения

Исключение Когда возникает
Bitrix\Main\ObjectException Конструктор не смог разобрать строку. Сообщение исключения — Incorrect date: и переданная строка

Особенности

Конструктор разбирает строку функцией date_parse_from_format и не требует точного совпадения с форматом. Конструктор выбрасывает исключение, только если при разборе больше одной ошибки, кроме лишних или недостающих символов. Поэтому конструктор принимает и исправляет такие строки:

  • конструктор пропускает лишние символы в конце строки, например время в строке '2026-01-15 13:45' для формата 'Y-m-d',
  • если в строке нет месяца или дня, конструктор ставит 1, например строка '2026-01' для формата 'Y-m-d' дает 1 января 2026 года,
  • конструктор переносит несуществующий день на следующий месяц, например '31.02.2025' для формата 'd.m.Y' дает 3 марта 2025 года.

Конструктор принимает маску в нотации PHP. Формат региональных настроек, например 'DD.MM.YYYY', переведите в маску методом convertFormatToPhp.

Примеры

Пример. Код создает дату из строки по маске PHP и выводит ее с временем:

<?php
use Bitrix\Main\Type\Date;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$date = new Date('2026-01-15', 'Y-m-d');

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

Код выведет 15.01.2026 00:00:00.

Пример. Код разбирает строку в формате региональных настроек и обрабатывает ошибку формата:

<?php
use Bitrix\Main\ObjectException;
use Bitrix\Main\Type\Date;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

try
{
    $date = new Date('15.01.2026');
    echo $date->format('Y-m-d');
}
catch (ObjectException $exception)
{
    echo 'Неверная дата';
}

При формате даты DD.MM.YYYY в региональных настройках код выведет 2026-01-15.

Смотрите также