Создать объект из времени пользователя DateTime::createFromUserTime

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

Доступно с версии: 14.0.18

Метод DateTime::createFromUserTime создает объект из строки, которую ввел пользователь в своем часовом поясе. Метод возвращает время сервера. Для этого метод сдвигает время на разницу между поясом пользователя и поясом сервера. Метод toUserTime выполняет обратный перевод.

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

public static function createFromUserTime($timeString)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
timeString* string Задает дату со временем или только дату в формате региональных настроек сайта

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

Возвращаемое значение

Метод возвращает объект DateTime со временем сервера.

Метод разбирает строку по формату даты и времени. Если конструктор не разобрал строку по этому формату, метод разбирает ее по формату даты и ставит время 00:00:00.

Метод выбирает пояс пользователя так же, как toUserTime. Метод не сдвигает время, если на сайте выключены часовые пояса, код отключил их методом CTimeZone::Disable или смещение пояса пользователя равно нулю.

Исключения

Исключение Когда возникает
Bitrix\Main\ObjectException Строка не подходит ни под формат даты и времени, ни под формат даты

Примеры

Пример. Код переводит время из формы во время сервера:

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

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

try
{
    $serverTime = DateTime::createFromUserTime('15.01.2026 18:00:00');
    echo $serverTime->format('Y-m-d H:i:s');
}
catch (ObjectException $exception)
{
    echo 'Неверная дата';
}

При формате DD.MM.YYYY HH:MI:SS в региональных настройках и поясе пользователя на три часа восточнее пояса сервера код выведет 2026-01-15 15:00:00. Если часовые пояса выключены, код выведет 2026-01-15 18:00:00.

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