Вывести дату в формате региональных настроек Date::toString
Модуль: main — подключать отдельно не нужно
Доступно с версии: 14.0.18
Метод Date::toString возвращает дату строкой в формате из региональных настроек. Метод берет формат методом getFormat и выводит дату методом format.
Сигнатура метода в классе Bitrix\Main\Type\Date:
public function toString(?Context\Culture $culture = null)
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| culture | ?Bitrix\Main\Context\Culture |
Задает региональные настройки, из которых метод берет формат. Если передать null, метод берет региональные настройки текущего сайта. По умолчанию — null |
Возвращаемое значение
Метод возвращает строку. Если региональных настроек нет ни в аргументе, ни в контексте, метод выводит дату в формате DD.MM.YYYY.
Приведение объекта к строке, например echo $date, вызывает toString без аргументов.
Класс DateTime переопределяет метод. Его метод выводит дату со временем и может переводить время в часовой пояс пользователя. Подробнее — на странице DateTime.
Примеры
Пример. Код выводит дату в формате текущего сайта и в формате региональных настроек с кодом en:
<?php
use Bitrix\Main\Localization\CultureTable;
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');
$culture = CultureTable::getList(['filter' => ['=CODE' => 'en']])->fetchObject();
echo $date->toString() . ' ' . $date->toString($culture);
При формате DD.MM.YYYY у текущего сайта и MM/DD/YYYY у настроек en код выведет 15.01.2026 01/15/2026.