datetimefield.php

См. документацию.

<?php
 
namespace Bitrix\Main\ORM\Fields;
 
use Bitrix\Main\ArgumentException;
use Bitrix\Main\ArgumentTypeException;
use Bitrix\Main\DB\SqlExpression;
use Bitrix\Main\Type\DateTime;

class DatetimeField extends DateField
{
    protected $useTimezone = true;

    public function __construct($name, $parameters = array())
    {
        ScalarField::__construct($name, $parameters);
    }

    public function configureUseTimezone($use = true)
    {
        $this->useTimezone = (bool) $use;
 
        return $this;
    }

    public function configureDefaultValueNow(): self
    {
        return $this->configureDefaultValue(static fn() => new DateTime());
    }

    public function getFetchDataModifiers()
    {
        $modifiers = parent::getFetchDataModifiers();
 
        if (!$this->useTimezone)
        {
            $modifiers[] = [__CLASS__, 'disableTimezoneFetchModifier'];
        }
 
        return $modifiers;
    }

    public function cast($value)
    {
        if ($value instanceof SqlExpression)
        {
            return $value;
        }
 
        if (!empty($value) && !($value instanceof DateTime))
        {
            $value = new DateTime($value);
        }
 
        if ($value instanceof DateTime)
        {
            $this->useTimezone
                ? $value->enableUserTime()
                : $value->disableUserTime();
        }
 
        return $value;
    }

    public function convertValueFromDb($value)
    {
        return $this->getConnection()->getSqlHelper()->convertFromDbDateTime($value);
    }

    public function convertValueToDb($value)
    {
        if ($value instanceof SqlExpression)
        {
            return $value;
        }
 
        try
        {
            return $value === null && $this->is_nullable
                ? $value
                : $this->getConnection()->getSqlHelper()->convertToDbDateTime($value);
        }
        catch (ArgumentTypeException $e)
        {
            $exceptionMsg = $this->entity
                ? "Type error in `{$this->name}` of `{$this->entity->getFullName()}`"
                : "Type error in `{$this->name}`";
 
            throw new ArgumentException(
                "{$exceptionMsg}: {$e->getMessage()}"
            );
        }
    }

    public static function disableTimezoneFetchModifier($time)
    {
        if ($time !== null)
        {
            $time->disableUserTime();
        }
 
        return $time;
    }

    public function getGetterTypeHint()
    {
        return $this->getNullableTypeHint('\\'.DateTime::class);
    }

    public function getSetterTypeHint()
    {
        return $this->getNullableTypeHint('\\'.DateTime::class);
    }
}